Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Enabling overlay ads

Focus mode
Enabling overlay ads - AWS Elemental MediaTailor

MediaTailor support for overlay ads is enabled by default. A specific SCTE-35 ad-marker type in the manifest triggers the insertion of an overlay ad. Because some players might not support client-side rendering of overlay ads, you can disable the feature at the session level.

To disable overlay-ad support using HLS or DASH playback prefixes:
  • From the player, initialize a new MediaTailor playback session using a request in one of the following formats, according to your protocol:

    • Example: HLS format

      GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
    • Example: DASH format

      GET mediatailorURL/v1/master/hashed-account-id/origin-id/asset-id?aws.overlayAvails=off
To disable overlay-ad support using the session-initialization prefix:
  • On the player, construct a JSON message body for the session initialization request to MediaTailor:

    • To disable ad-overlay support, add an overlays object as a top-level key with a value of off. The default overlays value is on.

    • (Optional) Provide any parameters that MediaTailor then passes to the ADS inside an adParams object. These parameters correspond to [player_params.param] settings in the ADS template URL of the MediaTailor configuration.

Example : HLS
POST master.m3u8 { "adsParams": { "deviceType": "ipad" }, "overlayAvails": "off" }
Example : DASH
POST manifest.mpd { "adsParams": { "deviceType": "androidmobile" }, "overlayAvails": "off" }
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.