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"
      }
    }
  }
});
PropertyDescriptionDefault
advertising objectSee: advertising object.-
airplay stringTooltip text and aria-label for Apple AirPlay casting icon in the control barAirplay
audioTracks stringTooltip text for and aria-label HTML attribute of the audio tracks menu iconAudio Tracks
auto stringLabel 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 viewerAuto
buffer stringaria-label for when player is in buffering stateLoading
captionsStyles 8.12.3+ objectSee captionStyles object-
cast stringTooltip text for and aria-label HTML attribute of the Google Chromecast casting icon in the control barChromecast
cc stringTooltip text for and aria-label HTML attribute of the closed captions menu iconClosed Captions
close stringTooltip text for and aria-label HTML attribute of the icon to close a menu or overlay.Close
displayHeading stringHeading text for an advertisement.Advertisement
errors objectSee: errors object.-
exitFullscreen 8.7.0+ stringWhen in fullscreen mode, tooltip text for and aria-label HTML attribute of the fullscreen icon in the control barExit Fullscreen
fullscreen stringTooltip text for and aria-label HTML attribute of the fullscreen icon in the control barFullscreen
hd stringTooltip text for and aria-label HTML attribute of the video Quality options menu iconQuality
liveBroadcast stringIn the control bar, label text and aria-label HTML attribute for live streamsLive
logo stringaria-label HTML attribute of the logo in the playerLogo
mute 8.7.0+ stringWhen the player is not muted, tooltip text for and aria-label HTML attribute of the volume icon in the control barMute
next stringaria-label HTML attribute of the right arrow in overlays with multiple pages of videosNext
nextUp stringTitle text and aria-label HTML attribute of the overlay that displays the next item to automatically play in a playlistNext Up
notLive stringIn 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 streamNot Live
off stringMenu option text for turning an option offOff
pipIcon stringTooltip text for and aria-label HTML attribute of the PiP icon in the control barPicture in Picture (PiP)
pause stringaria-label HTML attribute of the pause icon in the control barPause
play stringaria-label HTML attribute of the play icon in the control barPlay
playback stringCall-to-action text beneath the play button on the player idle screen.Play
playbackRates stringTooltip text for and aria-label HTML attribute of the playback rate controls menuPlayback Rates
player stringaria-label HTML attribute of the video player applicationVideo Player
playlist < 8.8.0 string Tooltip text for, overlay heading for, and aria-label HTML attribute of a playlist overlay

Starting with JW Player 8.8.0, use the related.heading property to set this property.
Playlist
poweredBy stringText displayed before the JW Player name and logo on a button in the Right-click menu.Powered by
prev stringaria-label HTML attribute of the left arrow in overlays with multiple pages of videosPrevious
related objectSee: related object.-
replay stringTooltip text for and aria-label HTML attribute of the replay button in the control bar, displayed at the completion of video playback.Replay
rewind stringTooltip text for and aria-label HTML attribute of the rewind button in the control barRewind 10 Seconds
settings stringTooltip text for and aria-label HTML attribute of the Settings menu iconSettings
sharing objectSee: sharing object.-
shortcuts 8.11.0+ objectSee shortcuts object.-
slider stringaria-label HTML attribute of the video scrub barSeek Slider
stop stringaria-label HTML attribute of the stop button in the control bar for live streams.Stop
unmute 8.7.0+ stringWhen the player is muted, tooltip text for and aria-label HTML attribute of the volume icon in the control barUnmute
videoInfo stringLabel text and aria-label HTML attribute of the Right-click menu button.About This Video
volume stringTooltip text for and aria-label HTML attribute of the volume in the control bar.Volume
volumeSlider stringaria-label HTML attribute of the volume slider in the control bar.Volume Slider

intl.{lang}.advertising object

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

PropertyDescriptionDefault
admessage stringCountdown message text that displays the remaining duration of an adThis ad will end in xx
cuetext stringTooltip text for and aria-label HTML attribute that indicates the content is an advertisement. Appears when a user mouses over a scheduled advertisement cue marker in the time slider.Advertisement
loadingAd stringText displayed when an ad is loadingLoading ad
podmessage stringText 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.
Ad xx of yy
skipmessage stringSkip countdown message text that displays the remaining duration before an ad can be skippedSkip ad in xx
skiptext stringButton text for and aria-label HTML attribute that indicates when an ad can be skippedSkip

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