Player Errors Reference (Web Player)
Identify player errors.
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 | null },
"type": "setupError"
}
Name | 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 | null | Lower level error or event, caught by the player, which resulted in this error |
type string | Category of error or warning Possible values:
|
An error has the following behaviors:
- Stops player functionality
- Displays the
code
andmessage
to the viewer - In log events, displays the
code
with a link to this document - Returns a
type
value oferror
orsetupError
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
andmessage
to the viewer - Returns a
type
value ofplayAttemptFailed
orwarning
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
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. |
101130 | Failed to load the jwplayer.amp 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 < 8.19.0 As per Adobe, Flash Player is no longer supported. | 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.
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. This includes the browser being unable to play the video, e.g. if the required codecs are not installed. | 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. |
102700 | When using the player setPlaylistItemCallback method to skip playlist items, all items in the playlist are skipped because the callback returned rejected Promises for each item. | - | This video cannot be played because of a technical error. |
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
Loading New Playlist
These errors are dispatched when jwplayer().load(content)
is called and the content cannot be loaded or played.
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()
.
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 < 8.19.0 As per Adobe, Flash Player is no longer supported. | 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Â <Â 8.19.0 As per Adobe, Flash Player is no longer supported. | An unknown error occurred in the Flash player. | <event.message> | This video file cannot be played. |
210001 < 8.19.0 As per Adobe, Flash Player is no longer supported. | 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 < 8.19.0 As per Adobe, Flash Player is no longer supported. | 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 < 8.19.0 As per Adobe, Flash Player is no longer supported. | 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.
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: | 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. JWP 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 | The manifest indicated protected content, but the manifest parser was unable to determine what key systems should be used. | Error loading media: File could not be played | This video file cannot be played. |
246001 8.22.2+ | None of the requested key system configurations are available. This may happen under the following conditions: • The key system is not supported. The key system does not support the features requested (e.g. persistent state). • A user prompt was shown and the user is denied access. The key system is not available from unsecure contexts. (i.e. requires HTTPS) | Error loading media: File could not be played | This video file cannot be played. |
246002Â 8.22.20+ | The browser found one of the requested key systems, but it failed to create an instance of the CDM for some unknown reason.error.data[0] is an error message string from the browser. | Error loading media: File could not be played | This video file cannot be played. |
246003 8.22.2+ | The browser found one of the requested key systems and created an instance of the CDM, but it failed to attach the CDM to the video for some unknown reason.error.data[0] is an error message string from the browser. | Error loading media: File could not be played | This video file cannot be played. |
246004 8.22.2+ | The CDM rejected the server certificate supplied by the application. The certificate may be malformed or in an unsupported format. | Error loading media: File could not be played | This video file cannot be played. |
246005 8.22.2+ | The CDM refused to create a session for some unknown reason. | Error loading media: File could not be played | This video file cannot be played. |
246006 8.22.2+ | The CDM was unable to generate a license request for the init data it was given. The init data may be malformed or in an unsupported format. | Error loading media: File could not be played | This video file cannot be played. |
246007 8.22.2+ | The license request failed. This could be a timeout, a network failure, or a rejection by the server. | Error loading media: File could not be played | This video file cannot be played. |
246008 8.22.2+ | The license response was rejected by the CDM. The server's response may be invalid or malformed for this CDM. | Error loading media: File could not be played | This video file cannot be played. |
246010 8.22.2+ | The manifest does not specify any DRM info, but the content is encrypted. Either the manifest or the manifest parser are broken. | Error loading media: File could not be played | This video file cannot be played. |
246012 8.22.2+ | No license server was given for the key system signaled by the manifest. A license server URI is required for every key system. | Error loading media: File could not be played | This video file cannot be played. |
246013 8.22.2+ | A required offline session was removed. The content is not playable. | Error loading media: File could not be played | This video file cannot be played. |
246014 8.22.2+ | The license has expired. This is triggered when all keys in the key status map have a status of 'expired.' | Error loading media: File could not be played | This video file cannot be played. |
246015 8.22.2+ | A server certificate wasn't given when it is required. FairPlay requires setting an explicit server certificate in the configuration. | Error loading media: File could not be played | This video file cannot be played. |
246016 8.22.2+ | An error was thrown while executing the init data transformation. | Error loading media: File could not be played | This video file cannot be played. |
246017 8.22.2+ | The server certificate request failed. | 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. | - | - |
301133 | The jwplayer.controls.tizen.js file failed to load. Tizen controls and styling will not be displayed. | - | - |
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. | - | - |
305007 | The bidding.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. | - | - |
305107 | The bidding.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 JWP 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. | - | - |
Media Playback HLS.JS warnings
A warning occurred while reproducing content with our HLS.JS Provider.
Code | Reason | Deprecated Error Message < 8.4.0 | Displayed Message |
---|---|---|---|
330000 | An unknown error occurred handling HLS media. | - | - |
332403 | A manifest request returned with a 403 HTTP status code. | - | - |
333000 | An unknown media loading error occurred. | - | - |
333001 | An HLS media request timed out. | - | - |
333006 | A media request returned with an HTTP status indicating failure. The code was outside of the 400 and 500 ranges. | - | - |
333400-333599 | A media request returned with an HTTP status indicating failure (eg. 333404 is HTTP status code 404). | - | - |
333600 | A media fragment could not be parsed. | - | - |
334001 | HLS playback has stalled because not enough media is buffered. | - | - |
334002 | An error occurred appending HLS media to the buffer. | - | - |
339000 | An internal error occurred handling an event callback during HLS playback. | - | - |
Casting
Updated about 1 year ago