Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginContact Sales

<img src="https://img.shields.io/badge/%20-ENTERPRISE-%23B10031" style="float:left"/><br />

JWP is excited to help you monetize your content. With that being said, the complex nature of video advertising means that ad-related errors will happen from time to time. We hope that this list of error codes provides some insight into possible reasons that you are seeing these errors. We also have included possible solutions that may lead you to being able to resolve the issue.

If you are still seeing ad-related issue after trying any applicable solutions, we highly recommend contacting your ad provider for further troubleshooting. This is because the player is primarily making the ad request using the URL you embed in the player and it is the responsibility of the ad provider to respond with a VAST-compatible response that the player can then display to your viewers. If they determine that they believe the issue is with the player, please open a case with [our Support Team](🔗).

<br /> <hr />

## Ad client specifications

Errors often happen because ad tags or creatives are out of spec with either VAST or Google IMA. For this reason, we encourage publishers to refer to the respective specifications for the ad client they are using below:

  • <a href="https://www.iab.com/guidelines/digital-video-ad-serving-template-vast-3-0/" target="_blank">VAST 3.0 Specification</a>

  • <a href="https://www.iab.com/guidelines/digital-video-ad-serving-template-vast-4-0/" target="_blank">VAST 4.0 Specification</a>

  • <a href="https://developers.google.com/interactive-media-ads/docs/sdks/html5/" target="_blank">Google IMA SDK for HTML5 v3</a>

<br /> <hr />

## Ad errors and warnings

  • [1xxxx](🔗): VAST general errors

  • [2xxxx](🔗): IMA errors

  • [5xxxx](🔗): VAST VPAID errors

  • [6xxxx](🔗): JWP ad errors

  • [7xxxx](🔗): JWP ad warnings

<br />

### VAST general errors

VAST Error CodeJW Error CodeErrorPossible CausesPossible SolutionsColumn Title
`100`<a name='10100'></a>`10100`XML parsing error<br />                                                                        VAST supplied is not a valid XML document.<br /><br />URL supplied does not resolve to a valid XML document.<br /><br />Perhaps a CORS issue.<br /><br />Check the CORS headers of the domain hosting the XML to make sure they are configured to allow the domain of the page access.<br /><br />
`101`<a name='10101'></a>`10101`VAST schema validation errorThe VAST validates as XML, but does not validate per the VAST schema. This could due to missing mandatory elements/attributes, or combinations of elements/attributes that are not permissible.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />Some ad providers use empty VAST 3.0 responses to show that they have received the request but do not wish to fill it.<br /><br />
`102`<a name='10102'></a>`10102`VAST version of response not supportedBidder did not respect the VAST version(s) in the bid request.<br /><br />Exchange is sending the wrong VAST version(s) in the bid request.<br /><br />The VAST does not contain the version. This could also be considered a schema validation issue.<br /><br />JWP 8 does not provide support for VAST 1.0 ads.<br /><br />
`301`<a name='10301'></a>`10301`Timeout of VAST URI provided in Wrapper element, or of VAST URI provided in a subsequent Wrapper elementInvalid URI<br /><br />Unreachable or request timeout for URI<br /><br />Security or other exceptions related to requesting a VAST URI<br /><br />This can be caused by requesting a secure (HTTPS) resource on a non-secure (HTTP) page<br /><br />Check that the VAST URI is valid and reachable<br /><br />Check whether this occurs more on mobile devices<br /><br />Check whether or not issue is reproducible on a non-secure (HTTP) version of your page<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience<br /><br />
`303`<a name='10303'></a>`10303`No ads VAST response after one or more Wrappers. Also includes the number of empty VAST responses from fallback.No Ad element in VAST document after following wrappers<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />
`400`<a name='10400'></a>`10400`General linear error. Video player is unable to display the linear ad.MediaFile is not a valid video file of the specified format<br /><br />Check to see if MediaFile’s format is valid and supported<br /><br />Does the MediaFile’s URI actually return a video asset?<br /><br />
`401`<a name='10401'></a>`10401`File not found. Unable to find Linear/MediaFile from URIURI of Linear/MediaFile is not valid<br /><br />Does the Linear/MediaFile’s URI actually return a valid asset?<br /><br />
`402`<a name='10402'></a>`10402`Timeout of MediaFile URIIssue with CDN server<br /><br />Timeout (in milliseconds) when loading a video ad media file. If loading takes longer than this timeout, the ad playback is canceled<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the media file<br /><br />Can occur when a video auto-plays in a mobile environment, since it should be click-to-play (there are some exceptions)<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience<br /><br />
`403`<a name='10403'></a>`10403`Could not find MediaFile that is supported by this video player, based on the attributes of the MediaFile element.Bidder did not respect the MIME types in the bid request<br /><br />Exchange did not send the correct MIME types<br /><br />This may indicate that the wrong creative type attempted to play. For example, a Flash creative attempted to play on a mobile device or a browser that does not support Flash.<br /><br />Ad is inline but no compatible media file is found. Generally, if the player reaches a point where it sees no MediaFiles in the array of mediafiles considered eligible.<br /><br />Reach out to your ad provider to request only HTML5-compatible creatives.<br /><br />
`405`<a name='10405'></a>`10405`Problem displaying MediaFileCORS issue on CDN server<br /><br />Unsupported codecs<br /><br />Mismatch between MIME type and video file type<br /><br />Unsupported delivery method<br /><br />

`408`<a name='10408'></a>`10408`Conditional ad rejectedThis is not so much an error as it is expected when the `conditionaladoptout` configuration option is enabled and a conditional ad is found.<br /><br />

`502`<a name='10502'></a>`10502`Unable to fetch NonLinearAds/NonLinear resourceIssue with CDN server<br /><br />

`900`<a name='10900'></a>`10900`Undefined errorThis error is usually fired when the error does not match the criteria of any of the other errors.<br /><br />

`1000`<a name='11000'></a>`11000`VMAP schema errorThe VPAID validates as XML, but does not validate per the VPAID schema. This could due to missing mandatory elements/attributes, or combinations of elements/attributes that are not permissible.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />Some ad providers use empty VAST 3.0 responses to show that they have received the request but do not wish to fill it.<br /><br />
`1002`<a name='11002'></a>`11002`VMAP parsing errorThis error can be fired when the error does not match the criteria of any of the other VMAP-related errors.<br /><br />

`1007`<a name='11007'></a>`11007`Ad response document retrieval timeoutIssue with CDN server<br /><br />Timeout (in milliseconds) when loading an ad response. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the ad response.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`1008`<a name='11008'></a>`11008`Ad response document retrieval errorCDN responsed with an error code.<br /><br />


<br /> <hr />

### VAST VPAID errors

VAST Error CodeJW Error CodeErrorPossible CausesPossible Solutions
`100`<a name='50100'></a>`50100`VPAID parsing error<br />                                                                        VAST supplied is not a valid XML document.<br /><br />URL supplied does not resolve to a valid XML document.<br /><br />Perhaps a CORS issue.<br /><br />Check on the CORS headers of the domain hosting the XML to make sure they are properly configured to allow the domain of the page access.<br /><br />
`400`<a name='50400'></a>`50400`VPAID general linear errorMediaFile is not a valid video file of the specified format.<br /><br />Check to see if MediaFile’s format is valid and supported.<br /><br />Does the MediaFile’s URI actually return a video asset?<br /><br />
`401`<a name='50401'></a>`50401`VPAID file not foundURI of Linear/MediaFile is not valid.<br /><br />Does the Linear/MediaFile’s URI actually return a valid asset?<br /><br />
`402`<a name='50402'></a>`50402`VPAID playback timed outIssue with CDN server.<br /><br />Timeout (in milliseconds) when loading a VPAID ad. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the VPAID ad.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`405`<a name='50405'></a>`50405`VPAID file could not be played

`900`<a name='50004'></a>`50004`VPAID ad request reached a timeoutIssue with CDN server.<br /><br />Timeout (in milliseconds) when loading a VPAID ad. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the VPAID ad.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`901`<a name='50901'></a>`50901`VPAID general errorThis is a general error that may be fired for a number of reasons due to the fact that VPAID ads often do not provide the player with a lot of information about errors.<br /><br />
`901`<a name='51901'></a>`51901`VPAID general errorVPAID creative fired a JavaScript exception that prevented successful playback. This can be, but is not limited to, syntax errors within the VPAID's JavaScript.<br /><br />Reach out to your ad provider.<br /><br />

<br /> <hr />

### IMA errors

IMA Error CodeJW Error CodeErrorPossible CausesPossible Solutions
-<a name='20000'></a>`20000`IMA SDK download failedAd blocker caused the IMA SDK not to download<br />                         
`100`<a name='20100'></a>`20100`VAST_MALFORMED_RESPONSE<br /><br />The ad response was not recognized as a valid VAST ad.VAST supplied is not a valid XML document.<br /><br />URL supplied does not resolve to a valid XML document.<br /><br />Perhaps a CORS issue.<br /><br />Check on the CORS headers of the domain hosting the XML to make sure they are properly configured to allow the domain of the page access.<br /><br />
`101`<a name='20101'></a>`20101`VAST_SCHEMA_VALIDATION_ERRORThe VAST validates as XML, but does not validate per the VAST schema. This could due to missing mandatory elements/attributes, or combinations of elements/attributes that are not permissible.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />Some ad providers use empty VAST 3.0 responses to show that they have received the request but do not wish to fill it.<br /><br />
`102`<a name='20102'></a>`20102`VAST_UNSUPPORTED_VERSIONBidder did not respect the VAST version(s) in the bid request.<br /><br />Exchange is sending the wrong VAST version(s) in the bid request.<br /><br />JWP 8 does not provide support for VAST 1.0 ads.<br /><br />
`200`<a name='20200'></a>`20200`VAST_TRAFFICKING_ERRORThe player received an ad type that it was not expecting and/or cannot display.<br /><br />
`201`<a name='20201'></a>`20201`VAST_UNEXPECTED_LINEARITYAd linearity is different from what the video player is expecting.<br /><br />
`202`<a name='20202'></a>`20202`VAST_UNEXPECTED_DURATION_ERRORVAST duration is different from the actual media file duration.<br /><br />
`300`<a name='20300'></a>`20300`VAST_WRAPPER_ERRORGeneral VAST wrapper error.<br /><br />
`301`<a name='20301'></a>`20301`VAST_LOAD_TIMEOUTInvalid URI<br /><br />Unreachable or request timeout for URI<br /><br />Security or other exceptions related to requesting a VAST URI.<br /><br />This can be caused by requesting a secure (HTTPS) resource on a non-secure (HTTP) page.<br /><br />Check that the VAST URI is valid and reachable.<br /><br />Check whether this occurs more on mobile devices.<br /><br />Check whether or not issue is reproducible on a non-secure (HTTP) version of your page.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`302`<a name='20302'></a>`20302`VAST_TOO_MANY_REDIRECTSThe maximum number of VAST wrapper redirects has been reached.<br /><br />
`303`<a name='20303'></a>`20303`VAST_NO_ADS_AFTER_WRAPPERNo Ad element in VAST document after following wrappers.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />
`400`<a name='20400'></a>`20400`VIDEO_PLAY_ERRORMediaFile is not a valid video file of the specified format.<br /><br />Check to see if MediaFile’s format is valid and supported.<br /><br />Does the MediaFile’s URI actually return a video asset?<br /><br />
`402`<a name='20402'></a>`20402`VAST_MEDIA_LOAD_TIMEOUTIssue with CDN server.<br /><br />Timeout (in milliseconds) when loading a video ad media file. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the media file.<br /><br />Can occur when a video auto-plays in a mobile environment, since it should be click-to-play (there are some exceptions).<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`403`<a name='20403'></a>`20403`VAST_LINEAR_ASSET_MISMATCHBidder did not respect the MIME types in the bid request.<br /><br />Exchange did not send the correct MIME types.<br /><br />This may indicate that the wrong creative type attempted to play. For example, a Flash creative attempted to play on a mobile device or a browser that does not support Flash.<br /><br />Ad is inline but no compatible media file is found. Generally, if the player reaches a point where it sees no MediaFiles in the array of mediafiles considered eligible.<br /><br />Reach out to your ad provider to request only HTML5-compatible creatives.<br /><br />
`405`<a name='20405'></a>`20405`VAST_PROBLEM_DISPLAYING_MEDIA_FILECORS issue on CDN server.<br /><br />Unsupported codecs.<br /><br />Mismatch between MIME type and video file type.<br /><br />Unsupported delivery method.<br /><br />
`500`<a name='20500'></a>`20500`OVERLAY_AD_PLAYING_FAILEDAn overlay ad failed to render.<br /><br />
`501`<a name='20501'></a>`20501`NONLINEAR_DIMENSIONS_ERRORUnable to display NonLinear ad because creative dimensions do not align with creative display area (i.e. creative dimension too large).<br /><br />
`502`<a name='20502'></a>`20502`OVERLAY_AD_LOADING_FAILEDIssue with CDN server<br /><br />
`503`<a name='20503'></a>`20503`VAST_NONLINEAR_ASSET_MISMATCHAssets were found in the VAST ad response for nonlinear ad, but none of them matched the video player's capabilities.<br /><br />
`602`<a name='20602'></a>`20602`COMPANION_REQUIRED_ERRORUnable to display one or more required companions. The master ad is discarded since the required companions could not be displayed.<br /><br />
`603`<a name='20603'></a>`20603`COMPANION_AD_LOADING_FAILEDA companion ad failed to load or render.<br /><br />
`900`<a name='20900'></a>`20900`UNKNOWN_ERRORAn unexpected error occurred and the cause is not known. Refer to the inner error for more information.<br /><br />This error is usually fired when the error does not match the criteria of any of the other errors.<br /><br />
`901`<a name='20901'></a>`20901`VPAID_ERRORA VPAID error occurred. Refer to the inner error for more information.<br /><br />
`1005`<a name='21005'></a>`21005`FAILED_TO_REQUEST_ADSThere was a problem requesting ads from the server.<br /><br />
`1007`<a name='21007'></a>`21007`VAST_ASSET_NOT_FOUNDNo assets were found in the VAST ad response.<br /><br />Issue with CDN server.<br /><br />Timeout (in milliseconds) when loading an ad response. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the ad response.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.
`1009`<a name='21009'></a>`21009`VAST_EMPTY_RESPONSEEmpty VAST response<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />
`1010`<a name='21010'></a>`21010`UNKNOWN_AD_RESPONSEThe ad response was not understood and cannot be parsed.<br /><br />
`1011`<a name='21011'></a>`21011`UNSUPPORTED_LOCALEThe language specified in the setLocale configuration option does not match any of the [two-letter ISO 639-1 country codes](🔗).<br /><br />
`1012`<a name='21012'></a>`21012`ADS_REQUEST_NETWORK_ERRORIssue with the CDN server.<br /><br />
`1013`<a name='21013'></a>`21013`INVALID_AD_TAGThe encoding of the ad tag URL is incorrect.<br /><br />Check the encoding of special characters in the URL of your ad tag.<br /><br />
`1020`<a name='21020'></a>`21020`STREAM_INITIALIZATION_FAILEDThe stream that contains server-side ad insertion fails to play.<br /><br />Contact your streaming provider.<br /><br />
`1021`<a name='21021'></a>`21021`ASSET_FALLBACK_FAILEDThe ad provider did not return a valid ad using the fallback.<br /><br />Contact your ad provider.<br /><br />
`1101`<a name='21101'></a>`21101`INVALID_ARGUMENTSYou probably will not see this error when using JWP.<br /><br />
`1105`<a name='21105'></a>`21105`INVALID_ADX_EXTENSIONAn invalid AdX extension was found.<br /><br />
`1205`<a name='21205'></a>`21205`AUTOPLAY_DISALLOWEDThe viewer’s autoplay settings in their browser prevented the ad from autoplaying.<br /><br />Configure your player to be click-to-play.<br /><br />

<br /> <hr />

### JWP ad errors

VAST Error CodeJW Error CodeErrorPossible CausesPossible SolutionsColumn Title
`900`<a name='60001'></a>`60001`Empty VAST response<br />                                                                        No Ad element in VAST document after following wrappers.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />Some ad providers use empty VAST 3.0 responses to show that they have received the request but do not wish to fill it.<br /><br />
-<a name='60002'></a>`60002`Ad limit reachedThe amount of ad impressions your account has generated in the calendar month exceeds the specified limit.<br /><br />Contact your JWP sales representative for more details or for upgrade options.<br /><br />
-<a name='60003'></a>`60003`Ad blockerThe viewer has an ad blocker app or extension installed for their browser.<br /><br />

-<a name='60004'></a>`60004`Tag download timeoutIssue with CDN server.<br /><br />Timeout (in milliseconds) when loading a VPAID ad response. If loading takes longer than this timeout, the ad playback is canceled.<br /><br />Can be caused by low bandwidth, or poor website implementation with competing requests that delay the loading of the VPAID ad response.<br /><br />The timeout is configurable for using the [creativeTimeout and requestTimeout configuration options](🔗). However, increasing the timeout could potentially negatively affect user experience.<br /><br />
`1002`<a name='60005'></a>`60005`Empty VMAP responseNo Ad element in VAST document after following wrappers.<br /><br />When working with third-party networks, the fill-rate can be less than 100%. If so, this is an expected error. For example, if the third-party expects to fill 60% of the time, you should expect 40% errors. You can check to ensure that the error rate is in line with the fill-rate of the third-party network.<br /><br />Some ad providers use empty VAST 3.0 responses to show that they have received the request but do not wish to fill it.<br /><br />
`900`<a name='60006'></a>`60006`Ad tag failed to downloadAn ad tag failed to download, but not inside of a wrapper.<br /><br />

`900`<a name='60007'></a>`60007`Failed to play because of an unsupported operating system.An ad tag failed to play because of an unsupported operating system.<br /><br />

-<a name='60008'></a>`60008`Bidding plugin is unavailableThe bidding plugin was unavailable when the ad was requested.<br /><br />Might be resolved in a later attempt.<br /><br />
-<a name='60009'></a>`60009`Not entitled for Player BiddingYour account is not entitled for Player Bidding.<br /><br />Contact your JWP sales representative for more details or for upgrade options.<br /><br />
-<a name='60900'></a>`60900`Unknown error



<br /> <hr />

### JWP ad warnings

VAST Error CodeJW Error CodeErrorPossible CausesPossible Solutions
`1002`<a name='70001'></a>`70001`Tracking events are missing `breakStart`, `breakEnd`, or error for `AdBreak` <br />                                                                        VMAP does not contain tracking events for the ad break. The ad will still play but there will not be pings sent for the events missing from the tracking events.Contact your ad provider.

<br />

(Script tags will be stripped)