The player supports subtitles in .srt,.ass, .ssaand .vttformats.

In iOS, the player switches in full screen mode to native interface, which supported only vtt format. So we recommend use this format.

You can pass URL of the source in the code by variable subtitle. It is important to consider cross-domain policy

The name of subtitle (usually a language) can be specified in square brackets

var player = new Playerjs({"subtitle":"[En]//", "file":"//"});

You can specify a listing:


Similarly, the subtitle variable is passed in Playlist and JS API.

From version 9.91 you can use spare subtitle links via the or operator. The player will load them if the first link does not work. or https//

Selecting subtitles is possible in the settings menu Settings / Settings menu

To customize the design use Plugins/ Subtitle

The parameter default_subtitle allows you to enable the desired subtitle language (if memorize option is enabled in the settings, it has priority).

var player = new Playerjs({"subtitle":"[En]//,[Es]//","default_subtitle":"Es"});

You can disable subtitles by default in the builder or using the subtitle_start:0 parameter.


The user can configure the subtitle display options. These settings open when you click on Options in the subtitle selection window.

Subtitles on iOS

The player transmits subtitles to the native iOS player interface if switching is in fullscreen mode. The native iOS player supports the VTT format and will show subtitles if they are loaded from the same domain. You can enable the Service / Cross-domain (CORS) option if the subtitles are not loading due to different domains.

Time correction

You can move subtitles in time if there is a de-sync. This only works if subtitles are uploaded as separate files and managed by the player. You can use the subshift parameter in tenths of a second. To shift back half a second:


You can also specify a shift in the subtitle source link


2024 © PlayerJS

Sign up free

Sign up
By signing up, you agree to Terms of Service
Login if you have an account

Restore password

Forgot email? Contact us