Internationalization

The intl object allows you to add new language translations, customize translations for player text and aria-label values, and access the benefits of the automated player localization feature.

🚧

Any existing language customizations or translations made outside of the intl object will override both automated player localization and intl object customizations. If you have configured language customizations or translations outside of the intl object, use the table below to copy those values into the corresponding intl.{lang}.{property}.

For each language, use a two-letter or locale-specific language code to define language-specific objects. Use the code example and tables below to configure the intl object.

jwplayer("myElement").setup({
    ...
    "intl": {

        // Quebec french sub-block
        "fr-ca": {
            "play": "reproduire"
        },

        // french sub-block
        "fr": {
            "replay": "Repeter",
            "play": "jouer"
        },

        // spanish sub-block
        "es": {
            "replay": "Repetir"
        },

        // frisian sub-block
        "fy": {
            "advertising": {
                "loadingAd": "Advertinsje lade"
            }
        }
    }
});

Property	Description
advertising object	See: advertising object
airplay string	Tooltip text and aria-label for Apple AirPlay casting icon in the control bar Default: Airplay
audioTracks string	Tooltip text for and aria-label HTML attribute of the audio tracks menu icon Default: Audio Tracks
auto string	Label text and aria-label HTML attribute of the default quality selection option that allows the player to automatically select the best quality level for the viewer Default: Auto
buffer string	aria-label for when player is in buffering state Default: Loading
captionsStyles 8.12.3+ object	See: captionsStyles object
cast string	Tooltip text for and aria-label HTML attribute of the Google Chromecast casting icon in the control bar Default: Chromecast
cc string	Tooltip text for and aria-label HTML attribute of the closed captions menu icon Default: Closed Captions
close string	Tooltip text for and aria-label HTML attribute of the icon to close a menu or overlay Default: Close
disabled string	Label to disable a feature Default: Disabled
enabled string	Label to enable a feature Default: Enabled
errors object	See: errors object
exitFullscreen 8.7.0+ string	When in fullscreen mode, tooltip text for and aria-label HTML attribute of the fullscreen icon in the control bar Default: Exit Fullscreen
fullscreen string	Tooltip text for and aria-label HTML attribute of the fullscreen icon in the control bar Default: Fullscreen
hd string	Tooltip text for and aria-label HTML attribute of the video Quality options menu icon Default: Quality
liveBroadcast string	In the control bar, label text and aria-label HTML attribute for live streams Default: Live
logo string	aria-label HTML attribute of the logo in the player Default: Logo
mute 8.7.0+ string	When the player is not muted, tooltip text for and aria-label HTML attribute of the volume icon in the control bar Default: Mute
next string	aria-label HTML attribute of the right arrow in overlays with multiple pages of videos Default: Next
nextUp string	Title text and aria-label HTML attribute of the overlay that displays the next item to automatically play in a playlist Default: Next Up
notLive string	In the control bar, label text and aria-label HTML attribute that indicates the current video position in a live stream lags behind the real-time stream Default: Not Live
off string	Menu option text for turning an option off Default: Off
pause string	aria-label HTML attribute of the pause icon in the control bar Default: Pause
pipIcon string	Tooltip text for and aria-label HTML attribute of the PiP icon in the control bar Default: Picture in Picture (PiP)
play string	aria-label HTML attribute of the play icon in the control bar Default: Play
playback string	Call-to-action text beneath the play button on the player idle screen Default: Play
playbackRates string	Tooltip text for and aria-label HTML attribute of the playback rate controls menu Default: Playback Rates
player string	aria-label HTML attribute of the video player application Default: Video Player
playlist \< 8.8.0 string	Tooltip text for, overlay heading for, and aria-label HTML attribute of a playlist overlay Starting with JWP 8.8.0, use the related.heading property to set this property. Default: Playlist
poweredBy string	Text displayed before the JW Player name and logo on a button in the right-click menu Default: Powered by
prev string	aria-label HTML attribute of the left arrow in overlays with multiple pages of videos Default: Previous
related object	See: related object.
replay string	Tooltip text for and aria-label HTML attribute of the replay button in the control bar, displayed at the completion of video playback Default: Replay
reset string	Label to reset options to their defaults Default: Reset
rewind string	Tooltip text for and aria-label HTML attribute of the rewind button in the control bar Default: Rewind 10 Seconds
settings string	Tooltip text for and aria-label HTML attribute of the Settings menu icon Default: Settings
sharing object	See: sharing object.
shortcuts 8.11.0+ object	See: shortcuts object.
slider string	aria-label HTML attribute of the video scrub bar Default: Seek
stop string	aria-label HTML attribute of the stop button in the control bar for live streams Default: Stop
unmute 8.7.0+ string	When the player is muted, tooltip text for and aria-label HTML attribute of the volume icon in the control bar Default: Unmute
videoInfo string	Label text and aria-label HTML attribute of the Right-click menu button Default: About This Video
volume string	Tooltip text for and aria-label HTML attribute of the volume in the control bar Default: Volume
volumeSlider string	aria-label HTML attribute of the volume slider in the control bar Default: Volume

intl.{lang}.advertising object

This object localizes the player text and ARIA labels of the advertising object.

intl.{lang}.captionsStyles object

This object localizes the captions styling menu displayed in the player.

intl.{lang}.errors object

This object localizes the error messages displayed in the player.

intl.{lang}.related object

This object localizes the player text and ARIA labels of the related object.

intl.{lang}.sharing object

This object localizes the player text and ARIA labels of the sharing object.

intl.{lang}.shortcuts object

This object localizes the keyboard shortcut menu items.

Transition table

Use the table below to copy old customization or translation values to the corresponding intl.{lang}.{property}.