If you want captions or subtitles to appear in your embedded player by default, you can do so by adjusting the embed code before placing it on your site.
Add the following text track parameter to the end of the player URL in your embed code:
?texttrack=
For example, if you want to turn on French subtitles or captions by default, your embed code should look like this:
<iframe src="https://player.vimeo.com/video/76979871?texttrack=fr" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
Here is another example with Spanish subtitles turned on by default:
<iframe src="https://player.vimeo.com/video/76979871?texttrack=es" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>
Note:
To add the text track when a privacy hash is present in the embed code, you should add an &
between query parameters (h
, texttrack
)
For example:
<iframe src="https://player.vimeo.com/video/76979871?h=69768d2afa&texttrack=en" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe>
To add auto-generated captions as in the embed code, you must add "texttrack=en-x-autogenerated".
For example:
<iframe src="https://player.vimeo.com/video/76979871?h=69768d2afa&texttrack=en-x-autogenerated" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe>
Please note that the language preference you set for the text track parameter must be represented by a lowercase ISO 639-1 language code. Optionally, you can also specify the locale and type of text track (examples: "en", "en-US", "en.captions", "en.subtitles"). You can find a list of standard language codes here.
Suppose you enter a language preference that hasn't yet been uploaded for your particular video. In that case, the text track parameter will be ignored, and your embedded video may load with CC or subtitles disabled by default. Also, please remember that viewers will still have the option to manually turn off or switch to a different language available for your video.
Lastly, please note that it's currently not possible to set captions or subtitles to appear by default for video pages on vimeo.com (e.g https://vimeo.com/76979871), or when embedding videos in applications that do not allow insertion of our iframe embed code.