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	(Deprecated) Tooltip text for, overlay heading for, and `aria-label` HTML attribute of a playlist overlay Starting with JW 8.8.0, use the `related.heading` property to set this property. Default: Playlist
poweredBy string	Text displayed before the JWX 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.

Property	Description
admessage string	Countdown message text that displays the remaining duration of an ads Default: This ad will end in xx
cuetext string	Tooltip text for and `aria-label` HTML attribute that indicates the content is an advertisement This appears when a user mouses over a scheduled advertisement cue marker in the time slider. Default: Advertisement
displayHeading string	Heading text for an advertisement Default: Advertisement
loadingAd string	Text displayed when an ad is loading Default: Loading ad
podmessage string	Text that displays during playback of an ad pod Use `AD_POD_CURRENT` to denote the currently playing item in the pod and `AD_POD_LENGTH` for the total number of ads in the pod. Default: Ad AD_POD_CURRENT of AD_POD_LENGTH.
skipmessage string	Skip countdown message text that displays the remaining duration before an ad can be skipped Default: Skip ad in xx
skiptext string	Button text for and `aria-label` HTML attribute that indicates when an ad can be skipped Default: Skip

intl.{lang}.captionsStyles object

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

Property	Description
backgroundColor string	Name of submenu to control the background color of subtitles Default: Background Color
backgroundOpacity string	Name of submenu to control the background transparency of subtitles Default: Background Opacity
black string	Name of color option Default: Black
blue string	Name of color option Default: Blue
edgeStyle string	Name of submenu to control the text decoration of subtitles Default: Character Edge
cyan string	Name of color option Default: Cyan
depressed string	Label for a captions style decoration where the text appears depressed or engraved Default: Depressed
dropShadow string	Label for a captions style decoration where the text has a shadow Default: Drop Shadow
color string	Name of submenu to control the font color of subtitles Default: Font Color
fontFamily string	Name of submenu to control the font of subtitles Default: Font Family
fontOpacity string	Name of submenu to control the transparency of subtitles Default: Font Opacity
userFontScale string	Name of submenu to control the size of subtitles Default: Font Size
green string	Name of color option Default: Green
magenta string	Name of color option Default: Magenta
none string	Label of a menu item to not select any option (similar to the concept of "off") Default: None
raised string	Label for a captions style decoration where the text appears raised or embossed Default: Raised
red string	Name of color option Default: Red
subtitleSettings string	Heading for the menu where you can change subtitles styles Default: Subtitle Settings
uniform string	Label for a captions style decoration where the text appears outlined Default: Uniform
white string	Name of color option Default: White
windowColor string	Name of submenu to control the window color of subtitles Default: Window Color
windowOpacity string	Name of submenu to control the transparency of the subtitle window Default: Window Opacity
yellow string	Name of color option Default: Yellow

intl.{lang}.errors object

This object localizes the error messages displayed in the player.

Property	Description
badConnection string	Error message text displayed when a connection issue prevents playback Default: This video cannot be played because of a problem with your internet connection.
cantLoadPlayer string	Error message text displayed when a player fails to instantiate due to a non-network reason For example: incorrect JSON or license keys Default: Sorry, the video player failed to load.
cantPlayInBrowser string	Error message text displayed when a video fails to start playback due to a browser support reason For example: such as Flash or DASH error or browser support Default: The video cannot be played in this browser.
cantPlayVideo string	Error message text displayed when a media item fails to load Default: This video file cannot be played.
errorCode string	Label text for a numeric error code For example: Error code: 50244402 Default: Error Code
liveStreamDown string	Error message text displayed when a live stream has technical issues or has ended Default: The live stream is either down or has ended.
protectedContent string	Error message text displayed when DRM or protected content fails Default: There was a problem providing access to protected content.
technicalError string	Fallback error message text displayed when no other error message is applicable Default: This video cannot be played because of a technical error.

intl.{lang}.related object

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

Property Description

Property	Description
autoplaymessage string	Countdown message text that displays the remaining duration before the next video begins to play Default: Next up in xx
heading string	Button text for, overlay heading for, and `aria-label` HTML attribute of recommended video interfaces Default: More Videos

autoplaymessage string

Countdown message text that displays the remaining duration before the next video begins to play

Default: Next up in xx

heading string

Button text for, overlay heading for, and aria-label HTML attribute of recommended video interfaces

Default: More Videos

intl.{lang}.sharing object

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

Property	Description
copied string	In the Sharing menu, tooltip text and `aria-label` HTML attribute for when a link is copied to the clipboard Default: Copied
email string	In the Sharing menu, label text for and `aria-label` HTML attribute of the option to email a video link in the sharing menu Default: Email
embed string	In the Sharing menu, label text for and `aria-label` HTML attribute of the option to copy embed code to clipboard Default: Embed
heading string	Tooltip text for and `aria-label` HTML attribute of the Sharing button in the control bar Default: Share
link string	In the Sharing menu, label text for and `aria-label` HTML attribute of the option to copy a link to clipboard Default: Link

intl.{lang}.shortcuts object

This object localizes the keyboard shortcut menu items.

Property	Description
captionsToggle string	Description of the keyboard shortcut behavior to toggle captions in the video Default: Captions On/Off
decreaseVolume string	Description of the keyboard shortcut behavior to decrease the volume of the video Default: Decrease Volume
fullscreenToggle string	Description of the keyboard shortcut behavior to toggle fullscreen Default: Fullscreen/Exit Fullscreen
increaseVolume string	Description of the keyboard shortcut behavior to increase the volume of the video Default: Increase Volume
keyboardShortcuts string	Heading for a list of all of the available keyboard shortcuts in the video player Default: Keyboard Shortcuts
playPause string	Description of the keyboard shortcut behavior to toggle playback Default: Play/Pause
seekBackward string	Description of the keyboard shortcut behavior to seek backward by 5 seconds in the video Default: Seek Backward
seekForward string	Description of the keyboard shortcut behavior to seek forward 5 seconds of the video Default: Seek Forward
seekPercent string	Description of the keyboard shortcut behavior to fast forward to a certain point in a video in a multiple of ten For example, you can press the 5 key to go to the 50% mark of the video. You can press the 2 key for 20% of the video. Default: Seek %
spacebar string	Name of the spacebar key on a keyboard Default: SPACE
volumeToggle string	Description of the keyboard shortcut behavior to toggle the volume Default: Mute/Unmute

Transition table

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

Old property	New property
`advertising.admessage`	`intl.{lang}.advertising.admessage`
`advertising.cuetext`	`intl.{lang}.advertising.cuetext`
`advertising.podmessage`	`intl.{lang}.advertising.podmessage`
`advertising.skipmessage`	`intl.{lang}.advertising.skipmessage`
`advertising.skiptext`	`intl.{lang}.advertising.skiptext`
`localization.airplay`	`intl.{lang}.airplay`
`localization.audioTracks`	`intl.{lang}.audioTracks`
`localization.buffer`	`intl.{lang}.buffer`
`localization.cast`	`intl.{lang}.cast`
`localization.cc`	`intl.{lang}.cc`
`localization.close`	`intl.{lang}.close`
`localization.copied` ^8.1.8+	`intl.{lang}.sharing.copied`
`localization.errors.badConnection`^8.4.0+	`intl.{lang}.errors.badConnection`
`localization.errors.cantLoadPlayer` ^8.4.0+	`intl.{lang}.errors.cantLoadPlayer`
`localization.errors.cantPlayInBrowser` ^8.4.0+	`intl.{lang}.errors.cantPlayInBrowser`
`localization.errors.cantPlayVideo` ^8.4.0+	`intl.{lang}.errors.cantPlayVideo`
`localization.errors.errorCode` ^8.4.0+	`intl.{lang}.errors.errorCode`
`localization.errors.liveStreamDown` ^8.4.0+	`intl.{lang}.errors.liveStreamDown`
`localization.errors.protectedContent` ^8.4.0+	`intl.{lang}.errors.protectedContent`
`localization.errors.technicalError` ^8.4.0+	`intl.{lang}.errors.technicalError`
`localization.fullscreen`	`intl.{lang}.fullscreen`
`localization.hd`	`intl.{lang}.hd`
`localization.liveBroadcast`	`intl.{lang}.liveBroadcast`
`localization.loadingAd`	`intl.{lang}.advertising.loadingAd`
`localization.more`	`intl.{lang}.next`
`localization.next`	`intl.{lang}.next`
`localization.nextUp`	`intl.{lang}.nextUp`
`localization.nextUpClose`	`intl.{lang}.close`
`localization.pause`	`intl.{lang}.pause`
`localization.play`	`intl.{lang}.play`
`localization.playback`	`intl.{lang}.playback`
`localization.playbackRates`	`intl.{lang}.playbackRates`
`localization.player`	`intl.{lang}.player`
`localization.playlist`	`intl.{lang}.playlist`
`localization.prev`	`intl.{lang}.prev`
`localization.related`	`intl.{lang}.related.heading`
`localization.replay`	`intl.{lang}.replay`
`localization.rewind`	`intl.{lang}.rewind`
`localization.stop`	`intl.{lang}.stop`
`localization.videoInfo`	`intl.{lang}.videoInfo`
`localization.volume`	`intl.{lang}.volume`
`related.autoplaymessage`	`intl.{lang}.related.autoplaymessage`
`sharing.heading`	`intl.{lang}.sharing.heading`
`sharing.link`	`intl.{lang}.sharing.link`