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
displayHeading string Heading text for an advertisement.

Default: Advertisement
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
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 Slider
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 Slider

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 ad

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
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 xx of yy
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.

PropertyDescriptionDefault
backgroundColor stringName of submenu to control the background color of subtitlesBackground Color
backgroundOpacityΒ stringName of submenu to control the backround transparency of subtitlesBackground Opacity
black stringName of color optionBlack
blue stringName of color optionBlue
characterEdge stringName of submenu to control the text decoration of subtitlesCharacter Edge
cyan stringName of color optionCyan
depressed stringLabel for a captions style decoration where the text appears depressed or engravedDepressed
disabled stringLabel to disable a featureDisabled
dropShadow stringLabel for a captions style decoration where the text has a shadowDrop Shadow
enabled stringLabel to enable a featureEnabled
fontColor stringName of submenu to control the font color of subtitlesFont Color
fontFamily stringName of submenu to control the font of subtitlesFont Family
fontOpacity stringName of submenu to control the transparency of subtitlesFont Opacity
fontSize stringName of submenu to control the size of subtitlesFont Size
green stringName of color optionGreen
magenta stringName of color optionMagenta
none stringLabel of a menu item to not select any option (similar to the concept of "off")None
raised stringLabel for a captions style decoration where the text appears raised or embossedRaised
red stringName of color optionRed
reset stringLabel to reset options to their defaultsReset
subtitleSettings stringHeading for the menu where you can change subtitles stylesSubtitle Settings
uniform stringLabel for a captions style decoration where the text appears outlinedUniform
white stringName of color optionWhite
windowColor stringName of submenu to control the window color of subtitlesWindow Color
windowOpacity stringName of submenu to control the transparency of the subtitle windowWindow Opacity
yellow stringName of color optionYellow

intl.{lang}.errors object

This object localizes the error messages displayed in the player.

PropertyDescriptionDefault
badConnection stringError message text displayed when a connection issue prevents playbackThis video cannot be played because of a problem with your internet connection.
cantLoadPlayer stringError message text displayed when a player fails to instantiate due to a non-network reason. For example: incorrect JSON or license keysSorry, the video player failed to load.
cantPlayInBrowserΒ stringError 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 supportThe video cannot be played in this browser.
cantPlayVideo stringError message text displayed when a media item fails to loadThis video file cannot be played.
errorCode stringLabel text for a numeric error code. (For example: Error code: 50244402)Error code
liveStreamDown stringError message text displayed when a live stream has technical issues or has endedThe live stream is either down or has ended.
protectedContent stringError message text displayed when DRM or protected content failsThere was a problem providing access to protected content.
technicalError stringFallback error message text displayed when no other error message is applicableThis 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.

PropertyDescriptionDefault
autoplaymessageΒ stringCountdown message text that displays the remaining duration before the next video begins to playNext up in xx
heading stringButton text for, overlay heading for, and aria-label HTML attribute of recommended video interfacesMore Videos

intl.{lang}.sharing object

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

PropertyDescriptionDefault
copied stringIn the Sharing menu, tooltip text and aria-label HTML attribute for when a link is copied to the clipboardCopied
email stringIn the Sharing menu, label text for and aria-label HTML attribute of the option to email a video link in the sharing menuEmail
embed stringIn the Sharing menu, label text for and aria-label HTML attribute of the option to copy embed code to clipboardEmbed
headingΒ stringTooltip text for and aria-label HTML attribute of the Sharing button in the control barShare
link stringIn the Sharing menu, label text for and aria-label HTML attribute of the option to copy a link to clipboardLink

intl.{lang}.shortcuts object


This object localizes the keyboard shortcut menu items.

PropertyDescriptionDefault
captionsToggle stringDescription of the keyboard shortcut behavior to toggle captions in the videoCaptions On/Off
decreaseVolume stringDescription of the keyboard shortcut behavior to decrease the volume of the videoDecrease Volume
fullscreenToggle stringDescription of the keyboard shortcut behavior to toggle fullscreenFullscreen/Exit Fullscreen
increaseVolume stringDescription of the keyboard shortcut behavior to increase the volume of the videoIncrease Volume
keyboardShortcutsΒ stringHeading for a list of all of the available keyboard shortcuts in the video playerKeyboard Shortcuts
playPause stringDescription of the keyboard shortcut behavior to toggle playbackPlay/Pause
seekBackward stringDescription of the keyboard shortcut behavior to seek backward by 5 seconds in the videoSeek Backward
seekForward stringDescription of the keyboard shortcut behavior to seek forward 5 seconds of the videoSeek Forward
seekPercent stringDescription 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. 2 key for 20% of the video.
Seek %
spacebar stringName of the spacebar key on a keyboardSPACE
volumeToggle stringDescription of the keyboard shortcut behavior to toggle the volume.Mute/Unmute

Transition table

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

Old propertyNew property
advertising.admessageintl.{lang}.advertising.admessage
advertising.cuetextintl.{lang}.advertising.cuetext
advertising.podmessageintl.{lang}.advertising.podmessage
advertising.skipmessageintl.{lang}.advertising.skipmessage
advertising.skiptextintl.{lang}.advertising.skiptext
localization.airplayintl.{lang}.airplay
localization.audioTracksintl.{lang}.audioTracks
localization.bufferintl.{lang}.buffer
localization.castintl.{lang}.cast
localization.ccintl.{lang}.cc
localization.closeintl.{lang}.close
localization.copied 8.1.8+intl.{lang}.sharing.copied
localization.errors.badConnection8.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.fullscreenintl.{lang}.fullscreen
localization.hdintl.{lang}.hd
localization.liveBroadcastintl.{lang}.liveBroadcast
localization.loadingAdintl.{lang}.advertising.loadingAd
localization.moreintl.{lang}.next
localization.nextintl.{lang}.next
localization.nextUpintl.{lang}.nextUp
localization.nextUpCloseintl.{lang}.close
localization.pauseintl.{lang}.pause
localization.playintl.{lang}.play
localization.playbackintl.{lang}.playback
localization.playbackRatesintl.{lang}.playbackRates
localization.playerintl.{lang}.player
localization.playlistintl.{lang}.playlist
localization.previntl.{lang}.prev
localization.relatedintl.{lang}.related.heading
localization.replayintl.{lang}.replay
localization.rewindintl.{lang}.rewind
localization.stopintl.{lang}.stop
localization.videoInfointl.{lang}.videoInfo
localization.volumeintl.{lang}.volume
related.autoplaymessageintl.{lang}.related.autoplaymessage
sharing.headingintl.{lang}.sharing.heading
sharing.linkintl.{lang}.sharing.link