JW Player

Player errors reference

Identify player errors.

Last Updated: November 16, 2019

All errors and warnings relating to the player are returned in a player error object.

{
  "code": 104153,
  "message": "Sorry, the video player failed to load.",
  "sourceError": { Error object or null },
  "type": "setupError"
}
Name Type Description
code Number Identifier for the error

Error code descriptions are listed on this page.
message String Error text displayed displayed to the user

This property can be localized.
sourceError Object or null Lower level error or event, caught by the player, which resulted in this error
type String Category of error or warning

Possible values include:

- error

- playAttemptFailed

- setupError

- warning

An error has the following behaviors:

  • Stops player functionality
  • Displays the code and message to the viewer
  • In log events, displays the code with a link to this document
  • Returns a type value of error or setupError

An warning has the following behaviors:

  • In log events, displays the code with a link to this document
  • May degrade player functionality
  • Does not display the code and message to the viewer
  • Returns a type value of playAttemptFailed or warning

Use the sections below to help you troubleshoot and programmatically handle player-related issues.

Setup Errors

These errors prevent the player from setting up successfully; they occur after jwplayer().setup() is called, are dispatched in a "setupError" event and prevent the dispatch of the "ready" event.

Miscellaneous

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
100000 An unknown setup error occurred. none Sorry, the video player failed to load.
100001 Setup took longer than 60 seconds to complete. Setup Timeout Error: Setup took longer than 30 seconds to complete. Sorry, the video player failed to load.
100011 Missing license key: the key was not found in the setup config or the jwplayer.key global. Error setting up player: Missing license key Sorry, the video player failed to load.
100012 Invalid license key. Error setting up player: Invalid license key Sorry, the video player failed to load.
100013 Expired license key. Error setting up player: Invalid license key Sorry, the video player failed to load.

Loading Javascript Components

Setup failed because the player could not load a necessary javascript component.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
101100 A component of the player failed to load. Network error Sorry, the video player failed to load.
101101 Failed to load the jwplayer.core component Network error Sorry, the video player failed to load.
101102 Failed to load the jwplayer.core.controls component Network error Sorry, the video player failed to load.
101103 Failed to load the jwplayer.core.controls.polyfills component Network error Sorry, the video player failed to load.
101104 Failed to load the jwplayer.core.controls.html5 component Network error Sorry, the video player failed to load.
101105 Failed to load the jwplayer.core.controls.polyfills.html5 component Network error Sorry, the video player failed to load.
101120 Failed to load the polyfills.intersection-observer component Network error Sorry, the video player failed to load.
104100 A playback component of the player (provider) failed to load Failed to load media Sorry, the video player failed to load.
104151 The provider.flash.js playback component of the player (Flash provider) failed to load Failed to load media Sorry, the video player failed to load.
104152 The provider.html5.js playback component of the player (HTML5 provider) failed to load Failed to load media Sorry, the video player failed to load.
104153 The provider.hlsjs.js playback component of the player (HLS.JS provider) failed to load Failed to load media Sorry, the video player failed to load.
104154 The provider.shaka.js playback component of the player (Shaka provider) failed to load Failed to load media Sorry, the video player failed to load.

Playlist Parsing

Setup failed because the requested playlist could not be parsed.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
102000 Unknown error. This is generally caused by an unknown XHR error or an exception thrown while parsing the content; for more context we recommend checking the source error. Error loading playlist: Error loading file Sorry, the video player failed to load.
102001 The XHR request exceeded the timeout argument or the default of 60 seconds. Error loading playlist: Timeout Sorry, the video player failed to load.
102002 The browser failed to make the XHR request because it does not support XMLHttpRequest. Error loading playlist: Error loading file Sorry, the video player failed to load.
102003 An exception was thrown while calling xhr.open. The reason varies depending on the browser, but the cause is usually a malformed URL. Error loading playlist: Error loading file Sorry, the video player failed to load.
102004 An exception was thrown while calling xhr.send. The reason varies depending on the browser. Error loading playlist: Error loading file Sorry, the video player failed to load.
102005 An exception was thrown in the XHR requestFilter. Error loading playlist: Error loading file Sorry, the video player failed to load.
102006 The XHR request failed with a status code outside of the 400 and 500 ranges. Error loading playlist: <xhr.status> (<xhr.statusText>) Sorry, the video player failed to load.
102007 The XHR request of a relative or protocol-relative URL failed because the page is hosted over the file:// protocol. We recommend either hosting your pages on the web, or using absolute paths with defined protocols. Error loading playlist: <xhr.status> (<xhr.statusText>) Sorry, the video player failed to load.
102400-102599 The XHR request failed and returned a valid HTTP status error (eg. 102404 is HTTP status code 404). Error loading playlist: File not found (http status code 404)
Error loading playlist: <xhr.status> (<xhr.statusText>)		 Sorry, the video player failed to load.
102601 The DOMParser could not parse the XML; it must be malformed. Error loading playlist: Invalid XML Sorry, the video player failed to load.
102602 The XML did not return a response; it must be malformed. Error loading playlist: Invalid XML Sorry, the video player failed to load.
102611 The JSON could not be parsed; it must be invalid. Error loading playlist: Invalid JSON Sorry, the video player failed to load.
102621 The requested playlist is not a valid RSS or JSON feed. Error loading playlist: Not a valid RSS/JSON feed Sorry, the video player failed to load.

Empty Playlist

Setup failed because an invalid playlist was requested.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
102630 Either an empty playlist was requested or none of the items passed our filter for valid files. No playable sources found This video file cannot be played.
102640 The playlist item could not be loaded because it is undefined or missing a valid source. No media This video file cannot be played.

Player Errors

These errors stop playback and display an error message on the player's UI. They occur after the "ready" event is triggered, and are dispatched in an "error" event.

Miscellaneous

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
200001 An exception occurred while completing the player's setup. none This video cannot be played because of a technical error.

Loading New Playlist

These errors are dispatched when jwplayer().load(content) is called and the content cannot be loaded or played.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
202000 Unknown error. This is generally caused by an unknown XHR error or an exception thrown while parsing the content; for more context we recommend checking the source error. Error loading playlist: Error loading file Sorry, the video player failed to load.
202001 Request exceeded timeout argument or default of 60 seconds. Error loading playlist: Timeout Sorry, the video player failed to load.
202002 The browser failed to make the XHR request because it does not support XMLHttpRequest. Error loading playlist: Error loading file Sorry, the video player failed to load.
202003 An exception was thrown while calling xhr.open. The reason varies depending on the browser, but the cause is usually a malformed URL. Error loading playlist: Error loading file Sorry, the video player failed to load.
202004 An exception was thrown while calling xhr.send. The reason varies depending on the browser. Error loading playlist: Error loading file Sorry, the video player failed to load.
202005 An exception was thrown in the XHR requestFilter. Error loading playlist: Error loading file Sorry, the video player failed to load.
202006 The XHR request failed with a status code outside of the 400 and 500 ranges. Error loading playlist: Error loading file Sorry, the video player failed to load.
202007 The XHR request of a relative or protocol-relative URL failed because the page is hosted over the file:// protocol. We recommend either hosting your pages on the web, or using absolute paths with defined protocols. Error loading playlist: <xhr.status> (<xhr.statusText>) Sorry, the video player failed to load.
202400-202599 The XHR request failed and returned a valid HTTP status error (eg. 202404 is HTTP status code 404). Error loading playlist: File not found (http status code 404)
Error loading playlist: <xhr.status> (<xhr.statusText>)		 Sorry, the video player failed to load.
202601 The DOMParser could not parse the XML; it must be malformed. Error loading playlist: Invalid XML Sorry, the video player failed to load.
202602 The XML did not return a response; it must be malformed. Error loading playlist: Invalid XML Sorry, the video player failed to load.
202611 The JSON could not be parsed; it must be invalid. Error loading playlist: Invalid JSON Sorry, the video player failed to load.
202621 The requested playlist is not a valid RSS or JSON feed. Error loading playlist: Not a valid RSS/JSON feed Sorry, the video player failed to load.
202630 Either an empty playlist was requested or none of the items passed our filter for valid files. Playlist error: No playable sources found Sorry, the video player failed to load.

Playlist Item

These errors occur when the player attempts to switch playlist items, either via normal playlist progression (an item ends and the following one loads) or when calling jwplayer().next().

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
203000 An error occurred when switching playlist items. N/A This video file cannot be played.
203100 A playback component of the player (the provider), required to play the requested item, failed to load between playlist items. Playlist error: Failed to load media This video file cannot be played.
203640 The playlist item could not be loaded because it is undefined or missing a valid source. Playlist error: No media This video file cannot be played.

Loading Javascript Components

These errors occur when jwplayer().load(content) is called but the provider required to reproduce the media failed to load.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
204100 A playback component of the player (the provider) failed to load. Could not play video: Failed to load media This video file cannot be played.
204151 The provider.flash.js playback component of the player (Flash provider) failed to load. Could not play video: Failed to load media This video file cannot be played.
204152 The provider.html5.js playback component of the player (HTML5 provider) failed to load. Could not play video: Failed to load media This video file cannot be played.
204153 The provider.hlsjs.js playback component of the player (HLS.JS provider) failed to load. Could not play video: Failed to load media This video file cannot be played.
204154 The provider.shaka.js playback component of the player (Shaka provider) failed to load. Could not play video: Failed to load media This video file cannot be played.

Media Playback Flash

An error occurred while reproducing content with our Flash Provider.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
210000 An unknown error occurred in the Flash player. <event.message> This video file cannot be played.
210001 The Flash player could not setup properly using the given player config. This error is generally browser specific. Failed to setup flash The video cannot be played in this browser.
210002 The Flash plugin was blocked from loading by the browser; the viewer must unblock the plugin to allow playback. This error is most likely to occur on IE11 for Windows 7, or when using a legacy media type that can only be played with Flash (e.g. FLV files). Flash plugin failed to load The video cannot be played in this browser.
214000 A media playback error occurred in the flash player. <event.message> This video file cannot be played.

Media Playback HTML5

An error occurred while reproducing content with our HTML5 Provider.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
220001 Occurs when a live stream has stalled for more than 30 seconds. The timeout can be configured at setup using config.liveTimeout. The live stream is either down or has ended The live stream is either down or has ended.
221000 An unknown network error occurred. Equivalent to the HTML5 MEDIA_ERR_NETWORK mediaError. Error loading media: Unknown network error This video cannot be played because of a problem with your internet connection.
224000 An unknown media error occurred. Error loading media: Unknown This video cannot be played because of a technical error.
224001 Failed to fetch the associated resource. Equivalent to the HTML5 MEDIA_ERR_ABORTED mediaError. Error loading media: Unknown operation aborted This video file cannot be played.
224002 Failed to decode the associated resource. Equivalent to the HTML5 MEDIA_ERR_DECODE mediaError. Error loading media: Unknown decode error This video file cannot be played.
224003 Failed to play the associated resource because it is not supported by this browser. Equivalent to the HTML5 MEDIA_ERR_SRC_NOT_SUPPORTED mediaError. Error loading media: File could not be played This video file cannot be played.
224005 The video tag src was set to empty ("") which resolved to the current page URL. - This video file cannot be played.
225006 The License required to decrypt a Fairplay stream could not be loaded. The XHR request failed with a status code outside of the 400 and 500 ranges. Error loading media: The license request failed There was a problem providing access to protected content.
225400-225599 The Server Certificate required to decrypt a Fairplay stream could not be loaded. The last 3 digits of the error code indicate the HTTP status code (eg. 225404 is HTTP status code 404). Error loading media: Failed to retrieve the server certificate There was a problem providing access to protected content.
225650 An error occurred when attempting to decrypt the Fairplay stream with the session key. Equivalent to Safari's "webkitkeyerror" event. Error loading media: Decryption key error was encountered There was a problem providing access to protected content.
226400-226599 The License required to decrypt a Fairplay stream could not be loaded. The last 3 digits of the error code indicate the HTTP status code (eg. 226404 is HTTP status code 404). Error loading media: The license request failed There was a problem providing access to protected content.

Media Playback HLS.JS

An error occurred while reproducing content with our HLS.JS Provider.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
230000 An unknown error occurred handling HLS media. - This video file cannot be played.
230001 Occurs when a live stream has stalled for more than 30 seconds. The timeout can be configured at setup using config.liveTimeout. The live stream is either down or has ended The live stream is either down or has ended.
230002 Playback stalled after going offline, resulting in an unrecoverable error. Network Error: No Internet Connection This video cannot be played because of a problem with your internet connection.
232000 Unknown manifest loading error. Cannot load M3U8: <data.reason>
Cannot load M3U8: <data.details>
* Cannot load M3U8: Unknown Network Error		 This video cannot be played because of a technical error.
232001 An HLS manifest request timed out. - This video file cannot be played.
232002 A manifest request failed as a result of having been offline. Network Error: Internet Connection Lost This video cannot be played because of a problem with your internet connection.
232006 A manifest request returned with an HTTP status indicating failure. The code was outside of the 400 and 500 ranges. Cannot load M3U8: <statusCode> <responseText> This video cannot be played because of a technical error.
232011 A manifest request was made without proper crossdomain credentials. Cannot load M3U8: Crossdomain access denied This video cannot be played because of a technical error.
232012 A manifest request was made to an HTTP resource from HTTPS. Cannot load M3U8: Unable to fetch HTTP resource over HTTPS This video cannot be played because of a technical error.
232400-232599 A manifest request returned with an HTTP status indicating failure. Cannot load M3U8: <statusCode> <responseText>
Cannot load M3U8: You do not have permission to access this content
* Cannot load M3U8: 404 Not Found		 This video cannot be played because of a technical error.
232600 The parent HLS manifest could not be parsed. - This video file cannot be played.
232631 The HLS rendition manifest did not contain playable media. - This video file cannot be played.
232632 The HLS manifest did not contain levels with compatible codecs. - The video cannot be played in this browser.
233000 An unknown media loading error occurred. Media Error: <data.reason>
Media Error: <data.details>
* Media Error: Unknown Network Error		 This video cannot be played because of a technical error.
233001 An HLS media request timed out. - This video file cannot be played.
233006 A media request returned with an HTTP status indicating failure. The code was outside of the 400 and 500 ranges. Media Error: <statusCode> <responseText> This video cannot be played because of a technical error.
233011 A media request was made without proper crossdomain credentials. Media Error: Crossdomain access denied This video cannot be played because of a technical error.
233012 A media request was made to an HTTP resource from HTTPS. Media Error: Unable to fetch HTTP resource over HTTPS This video cannot be played because of a technical error.
233400-233599 A media request returned with an HTTP status indicating failure (eg. 233404 is HTTP status code 404). Media Error: <statusCode> <responseText>
Media Error: You do not have permission to access this content
* Media Error: 404 Not Found		 This video cannot be played because of a technical error.
233600 A media fragment could not be parsed. - This video file cannot be played.
233650 An AES encoded fragment could not be decrypted. - This video file cannot be played.
234001 HLS playback has stalled because not enough media is buffered. - This video file cannot be played.
234002 An error occurred appending HLS media to the buffer. - This video file cannot be played.
235001 An HLS AES key request timed out. - This video file cannot be played.
239000 An internal error occurred handling an event callback during HLS playback. - This video file cannot be played.

Media Playback Shaka

An error occurred while reproducing content with our Shaka Provider.

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
240000 A miscellaneous and uncategorized DASH related error occurred. Error loading media: File could not be played This video file cannot be played.
241000 Unknown network error. Error loading media: File could not be played This video cannot be played because of a technical error.
241001 A DASH-related network request timed out. Error loading media: File could not be played This video file cannot be played.
241004 A DASH-related network request could not be made because the url is malformed. Error loading media: File could not be played This video file cannot be played.
241005 An error was thrown inside a DASH-related network filter. Error loading media: File could not be played This video file cannot be played.
241006 A network request returned with an HTTP status indicating failure; the code was outside of the 400 and 500 ranges. Error loading media: Unknown Network Error This video cannot be played because of a technical error.
241011 A network request was made without proper crossdomain credentials. Error loading media: Crossdomain access denied This video cannot be played because of a technical error.
241012 A network request was made to an HTTP resource from HTTPS. Error loading media: Unable to fetch HTTP resource over HTTPS This video cannot be played because of a technical error.
241400-241599 A network request returned with an HTTP status indicating failure (eg. 241404 is HTTP status code 404). Error loading media: <statusCode> <responseText>
Error loading media: You do not have permission to access this content
* Error loading media: 404 Not Found		 This video cannot be played because of a technical error.
242600 A miscellaneous DASH-related manifest parsing error occurred. Error loading media: File could not be played This video file cannot be played.
242601 An invalid XML DASH-related manifest parsing error occurred. Error loading media: File could not be played This video file cannot be played.
242632 The DASH manifest does not contain any content supported by the current browser. Error loading media: File could not be played The video cannot be played in this browser.
242635 Key system restrictions prevented playback of a DASH manifest. Error loading media: File could not be played This video file cannot be played.
244000 A miscellaneous DASH-related media error occurred. Error loading media: File could not be played This video file cannot be played.
244001-244003 The video element reported an error during DASH playback. Error loading media: File could not be played This video file cannot be played.
244604 The MP4 SIDX parser found the wrong box type.

JW Player attempts to switch levels when this occurs but triggers this error when there are no other levels to select.		 Error loading media: File could not be played This video file cannot be played.
246000 A miscellaneous DASH-related DRM error occurred. Error loading media: File could not be played This video file cannot be played.
249000 A miscellaneous DASH-related player error occurred. Error loading media: File could not be played This video file cannot be played.
340000 A recoverable DASH-related error has been thrown. Error loading media: File could not be played This video file cannot be played.

playAttemptFailed Warnings

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
303200 The play attempt failed for unknown reasons. - -
303210 The play attempt was interrupted for unknown reasons. - -
303212 The play attempt was interrupted by a new load request. - -
303213 The play attempt was interrupted by a call to pause(). - -
303220 The play attempt failed because the user didn't interact with the document first, or disabled auto-play completely. - -
303230 The play attempt failed because no supported source was found. - -

Warnings

When a warning occurs, video player functionality is not interrupted, but may be degraded.

Loading Javascript Components

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
301121 The polyfills.webvtt.js file failed to load. VTT captions cannot be displayed. Captions renderer failed to load -
301129 The related.js file failed to load. - -
301130 The jwplayer.controls.js failed to load. Controls will not be displayed. Controls failed to load -
301131 The vttparser.js file failed to load. VTT captions cannot be displayed. Captions failed to load -
301132 The jwplayer.vr.js file failed to load. 360 VR video may still play, but cannot be rendered in 360 mode. - -
301161 The provider.cast.js file failed to load. Chromecast cannot be enabled. Casting failed to load -
301162 The provider.airplay.js file failed to load. Airplay cannot be enabled. Casting failed to load -
305000 An unknown plugin file failed to load. - -
305001 The jwpsrv.js file failed to load. - -
305002 The googima.js file failed to load. - -
305003 The vast.js file failed to load. - -
305004 The freewheel.js file failed to load. - -
305005 The dai.js file failed to load. - -
305006 The gapro.js file failed to load. - -
305100 An unknown plugin file loaded, but was not registered. - -
305101 The jwpsrv.js file loaded, but was not registered. - -
305102 The googima.js file loaded, but was not registered. - -
305103 The vast.js file loaded, but was not registered. - -
305104 The freewheel.js file loaded, but was not registered. - -
305105 The dai.js file loaded, but was not registered. - -
305106 The gapro.js file loaded, but was not registered. - -

Related

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
302001 Request exceeded timeout argument or default of 60 seconds. - -
302002 The browser failed to make the request because XMLHttpRequest is not supported. - -
302003 An exception was thrown calling xhr.open. This is usually due to a malformed URL. - -
302004 An exception was thrown calling xhr.send. - -
302400-302599 An HTTP status error occurred. - -
302601 Playlist was a malformed XML file. - -
302602 Playlist XML was empty. - -
302611 Playlist was a malformed JSON file. - -

Captions

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
306001 Request exceeded timeout argument or default of 60 seconds. Captions failed to load -
306002 The browser failed to make the request because XMLHttpRequest is not supported. Captions failed to load -
306003 An exception was thrown calling xhr.open. This is usually due to a malformed URL. Captions failed to load -
306004 An exception was thrown calling xhr.send. Captions failed to load -
306400-306599 An HTTP status error occurred. Captions failed to load -
306005 DFXP captions could not be parsed due to an invalid DFXP file. Captions failed to load -
306006 XML could not be parsed from the DFXP file. Captions failed to load -
306007 The DFXP file did not contain XML. Captions failed to load -
306008 VTT captions could not be parsed due to an invalid VTT file. Captions failed to load -
306009 An unknown captions parsing error occurred. Captions failed to load -

VR

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
307000 Unknown VR plugin error. - -
307001 The browser does not support WebGL, which is required to render 360 video. Video will be rendered without 3D transformation. 360° video playback is not supported in this browser. -
307012 VR cannot be rendered from a cross-origin resource.

If using a resource hosted by JW Player make sure to use an adaptive m3u8 or mpd files. An mp4 file redirect should not be used as a VR source. This type of redirect will cause this error.		 - -

Localization

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
308000 An unknown error occurred while trying to load one of the translation JSON files. - -
308001 Request exceeded timeout argument or default of 60 seconds. - -
308400-308599 An attempt to load a translation JSON file resulted in an HHTP status error - -
308611 A translation JSON file could not be parsed. - -
308640 An attempt to load a translation JSON file resulted in an empty response. - -

Casting

Code Reason Deprecated Error Message < 8.4.0 Displayed Message
350000 A cast server error has occurred. - -

Player errors reference

Identify player errors.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.