# HLS CUE tag ad markers in AWS Elemental MediaPackage
<a name="ext-x-cue-ad-marker"></a>

CUE tag ad markers are used to signal ads and program transitions in live HLS manifests using industry-standard CUE tags. When you enable SCTE-35 enhanced ad markers on your HLS or LLHLS origin endpoint, MediaPackage inserts `EXT-X-CUE-OUT`, `EXT-X-CUE-IN`, and related CUE tags into the manifest where there are SCTE-35 `time_signal` or `splice_insert` tags present. This format provides the same SCTE-35 information as DATERANGE tags but in a different manifest format that's compatible with legacy ad insertion systems.

The CUE tags generated by MediaPackage include:
+ `EXT-X-CUE-OUT` - Signals the start of an ad break
+ `EXT-X-CUE-IN` - Signals the end of an ad break
+ `EXT-X-CUE-OUT-CONT` - Continuation of ad break across segments
+ `EXT-OATCLS-SCTE35` - OATCLS-specific SCTE-35 data
+ `EXT-X-ASSET` - Asset identification tags

 For information about CUE tags for HLS, see the [HTTP Live Streaming 2nd Edition Specification](https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-07#section-4.4.5.1).

The following table describes how to enable CUE tag ad markers in MediaPackage.

------
#### [ Console ]

To enable CUE tag ad markers when creating or editing an origin endpoint, in the MediaPackage console, under the HLS or LL-HLS manifest settings, **SCTE configuration**, **Ad markers**, choose **SCTE-35 enhanced**.

------
#### [ AWS CLI ]

To enable CUE tag ad markers for your origin endpoint, run the following command in the AWS CLI replacing *region* with your own information:

```
  aws --endpoint=https://mediapackagev2.region.amazonaws.com mediapackagev2 --region region create-origin-endpoint --channel-group-name test_channel_group --channel-name test_channel --origin-endpoint-name hls_endpoint
  --hls-manifests "[{\"ManifestName\":\"main\",\"ScteHls\":{\"AdMarkerHls\":\"SCTE35_ENHANCED\"}}]"
```

------
#### [ API and SDK ]

 To learn how to enable CUE tag ad markers for TS and CMAF origin endpoints via the MediaPackage live API or AWS SDK, see the following: 
+ [MediaPackage Live API reference ](https://docs.aws.amazon.com/mediapackage/latest/APIReference/API_ScteHls.html)
+ [AWS SDK](https://aws.amazon.com/getting-started/tools-sdks/)

------

## Example HLS manifest showing SCTE-35 CUE tag signaling
<a name="cue-example"></a>

This example shows a HLS manifest generated by MediaPackage using CUE tags to signal events in the live stream.

```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:11
#EXTINF:3.3600001,
segment_h264_720p25_731013628.ts
#EXT-OATCLS-SCTE35:/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXT-X-ASSET:CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531
#EXT-X-CUE-OUT:30.04
#EXTINF:3.36,
segment_h264_720p25_731013629.ts
#EXT-X-CUE-OUT-CONT:ElapsedTime=3.36,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.4,
segment_h264_720p25_731013630.ts
#EXT-X-CUE-OUT-CONT:ElapsedTime=5.76,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.4,
segment_h264_720p25_731013631.ts
...
#EXT-X-CUE-OUT-CONT:ElapsedTime=27.36,Duration=30.04,CAID=0x423A5032496E6E696E67314F766572332C503A50322C543A4F7665722C533A332C493A312C433A50522D32352D303138333531,SCTE35=/DBhAAAAAAAAAP/wBQb/tnKlYABLAklDVUVJBAAAE3//AAApQPAOM0I6UDJJbm5pbmcxT3ZlcjMsUDpQMixUOk92ZXIsUzozLEk6MSxDOlBSLTI1LTAxODM1MTQAAAAAF2kX6w==
#EXTINF:2.68,
segment_h264_720p25_731013640.ts
#EXT-OATCLS-SCTE35:/DBaAAAAAAAAAP/wBQb/tpyBAABEAkJDVUVJBAAAE3+/DjNCOlAySW5uaW5nMU92ZXIzLFA6UDIsVDpPdmVyLFM6MyxJOjEsQzpQUi0yNS0wMTgzNTE1AAD7WvT6
#EXT-X-CUE-IN
#EXTINF:2.4,
segment_h264_720p25_731013641.ts
#EXT-X-ENDLIST
```