By default, the web player uses [automated player localization](🔗). This feature creates a seamless and immersive viewer experience by automatically translating all player tooltips, error messages, headings, and ARIA labels into the same language as your page content.
Publishers typically customize the player text due to one of the reasons in the table.
Reason | Description |
**Word choice** | The chosen default word does not align with your brand or market |
**Unsupported language** | A language is not currently supported language<br /><br />If your language is unsupported, [submit a request for a new language](🔗) before continuing with the instructions listed in this article. |
<br />
To address either of the reasons in the table above, you can create an internationalization (`intl
`) object. You can customize translations of specific words in the following categories:
[General player elements](🔗) <sup>8.6.0+</sup>
[Advertising](🔗) <sup>8.6.0+</sup>
[Captions styling menu](🔗) <sup>8.12.3+</sup>
[Error messages](🔗) <sup>8.6.0+</sup>
[Keyboard shortcuts](🔗) <sup>8.11.0+</sup>
[Playlist overlay](🔗) <sup>8.6.0+</sup>
[Sharing](🔗) <sup>8.6.0+</sup>
<br /> <hr />
## Customize text
To customize a translation in any given language, use the following steps.
Create an `
intl
` object.Within the `
intl
` object, create an object that uses the appropriate two-letter (<a href="https://www.w3schools.com/tags/ref_language_codes.asp" target="_blank">ISO 639-1</a>) or locale-specific (ISO 639-1 <a href="https://www.w3schools.com/tags/ref_language_codes.asp" target="_blank">language</a>-<a href="https://www.w3schools.com/tags/ref_country_codes.asp" target="_blank">country</a> combination) language code. The language code of the object should correspond to the language defined in HTML <a href="https://www.w3schools.com/tags/att_global_lang.asp" target="_blank">lang</a> attribute of the page.Customize the translation by defining the value of the property.
<br />
The following example shows custom translations in multiple languages for different player elements.
<br />