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 andintl
object customizations. If you have configured language customizations or translations outside of theintl
object, use the table below to copy those values into the correspondingintl.{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 | 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.
intl.{lang}.captionsStyles object
This object localizes the captions styling menu displayed in the player.
Property | Description | Default |
---|---|---|
backgroundColor string | Name of submenu to control the background color of subtitles | Background Color |
backgroundOpacityΒ string | Name of submenu to control the backround transparency of subtitles | Background Opacity |
black string | Name of color option | Black |
blue string | Name of color option | Blue |
characterEdge string | Name of submenu to control the text decoration of subtitles | Character Edge |
cyan string | Name of color option | Cyan |
depressed string | Label for a captions style decoration where the text appears depressed or engraved | Depressed |
disabled string | Label to disable a feature | Disabled |
dropShadow string | Label for a captions style decoration where the text has a shadow | Drop Shadow |
enabled string | Label to enable a feature | Enabled |
fontColor string | Name of submenu to control the font color of subtitles | Font Color |
fontFamily string | Name of submenu to control the font of subtitles | Font Family |
fontOpacity string | Name of submenu to control the transparency of subtitles | Font Opacity |
fontSize string | Name of submenu to control the size of subtitles | Font Size |
green string | Name of color option | Green |
magenta string | Name of color option | Magenta |
none string | Label of a menu item to not select any option (similar to the concept of "off") | None |
raised string | Label for a captions style decoration where the text appears raised or embossed | Raised |
red string | Name of color option | Red |
reset string | Label to reset options to their defaults | Reset |
subtitleSettings string | Heading for the menu where you can change subtitles styles | Subtitle Settings |
uniform string | Label for a captions style decoration where the text appears outlined | Uniform |
white string | Name of color option | White |
windowColor string | Name of submenu to control the window color of subtitles | Window Color |
windowOpacity string | Name of submenu to control the transparency of the subtitle window | Window Opacity |
yellow string | Name of color option | Yellow |
intl.{lang}.errors object
This object localizes the error messages displayed in the player.
Property | Description | Default |
---|---|---|
badConnection string | Error message text displayed when a connection issue prevents playback | 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 | 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 | The video cannot be played in this browser. |
cantPlayVideo string | Error message text displayed when a media item fails to load | This video file cannot be played. |
errorCode string | Label text for a numeric error code. (For example: Error code: 50244402) | Error code |
liveStreamDown string | Error message text displayed when a live stream has technical issues or has ended | The live stream is either down or has ended. |
protectedContent string | Error message text displayed when DRM or protected content fails | There was a problem providing access to protected content. |
technicalError string | Fallback error message text displayed when no other error message is applicable | 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.
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.
Property | Description | Default |
---|---|---|
captionsToggle string | Description of the keyboard shortcut behavior to toggle captions in the video | Captions On/Off |
decreaseVolume string | Description of the keyboard shortcut behavior to decrease the volume of the video | Decrease Volume |
fullscreenToggle string | Description of the keyboard shortcut behavior to toggle fullscreen | Fullscreen/Exit Fullscreen |
increaseVolume string | Description of the keyboard shortcut behavior to increase the volume of the video | Increase Volume |
keyboardShortcutsΒ string | Heading for a list of all of the available keyboard shortcuts in the video player | Keyboard Shortcuts |
playPause string | Description of the keyboard shortcut behavior to toggle playback | Play/Pause |
seekBackward string | Description of the keyboard shortcut behavior to seek backward by 5 seconds in the video | Seek Backward |
seekForward string | Description of the keyboard shortcut behavior to seek forward 5 seconds of the video | 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. 2 key for 20% of the video. | Seek % |
spacebar string | Name of the spacebar key on a keyboard | SPACE |
volumeToggle string | Description 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 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 |