JW Player Errors Reference (JW Player 8.4+)

JW Player 8.4 introduces a new and improved error system in the player. We have revamped error codes from the ground up to be more comprehensive, descriptive, and consistent. This will enable faster troubleshooting and programmatic handling of errors for developers. The viewer experience is also enriched due to clearer messages accompanied by specific codes. To summarize, our new error system:

  • Assigns unique error codes to all errors
  • Provides explanations for all error codes in this document
  • Assigns a viewer-friendly message to each error
  • Supports localization of error messages
  • Displays errors to developers in log events with hyperlinks to this document
  • Displays the error code on the Player's error screen to facilitate error reporting by viewers


Player Error Object

Properties

Name Type Attributes Description
message string The error message displayed to the user.
code Number optional The error code used to identify the error. Error code descriptions are listed on this page.
sourceError Error or Event optional The lower level error or event, caught by the player, which resulted in this error.

Example

{
  "code": 104153,
  "message": "Sorry, the video player failed to load.",
  "sourceError": { Error object or null },
  "type": "setupError"
}


Error Messages

The message property contains the viewer-friendly text displayed on the player's error screen. Error messages are localizable. Visit the localization reference for more information.


Jump to Specific Error Type

Category Types
Setup Errors Misc | Loading Javascript Components | Playlist Parsing | Empty Playlist
Player Errors Misc |Loading New Playlist | Playlist Item | Loading Javascript Components | Flash | HTML5 | HLS.JS | Shaka


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 (Prior to 8.4.0) Displayed Message
100000 An unknown setup error occurred. none Sorry, the video player failed to load.
100001 Setup took longer than 30 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 (Prior to 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 (Prior to 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: () 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 (Prior to 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 (Prior to 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 (Prior to 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.
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 (Prior to 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 (Prior to 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 occured while reproducing content with our Flash Provider.

Code Reason Deprecated Error Message (Prior to 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 occured while reproducing content with our HTML5 Provider.

Code Reason Deprecated Error Message (Prior to 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 technical error.
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 cannot be played because of a technical error.
224002 Failed to decode the associated resource. Equivalent to the HTML5 MEDIA_ERR_DECODE mediaError. Error loading media: Unknown decode error This video cannot be played because of a technical error.
224003 Failed to reproduce the associated resource because its playback is not supported by this provider. Equivalent to the HTML5 MEDIA_ERR_SRC_NOT_SUPPORTED mediaError. Error loading media: File could not be played This video cannot be played because of a technical error.
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 occured while reproducing content with our HLS.JS Provider.

Code Reason Deprecated Error Message (Prior to 8.4.0) Displayed Message
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.
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: 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.
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.
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.

Media Playback Shaka

An error occured while reproducing content with our Shaka Provider.

Code Reason Deprecated Error Message (Prior to 8.4.0) Displayed Message
240000 Unknown shaka error; for more context we recommend checking the source error. Error playing file: Unknown playback error This video cannot be played because of a technical error.
241000 Unknown network error. Error loading media: File could not be played This video cannot be played because of a technical error.
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.