Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources

EMBER to CDF Mapping Reference

Enhanced Metadata Bridge for Entertainment Resources (EMBER) is Amazon's latest schema for uploading catalog data. EMBER replaces the older Catalog Data Format (CDF) schema. This page provides the field mapping between EMBER and CDF catalogs.

Program catalog

EMBER uses the ProgramCatalog element to contain metadata for all programs, such as movies and TV series. In CDF, program metadata is contained within the Works element. The following table maps elements from the EMBER program catalog to CDF works.

EMBER program catalog CDF works
Movie Movie
TVEpisode TvEpisode
TVSeason TvSeason
TVSeries TvShow
SportsEvent –
Event –
OffAir –
Other –
ToBeAnnounced –
Extra Extra

The following table maps EMBER attributes and elements used in the program catalog to CDF elements.

EMBER program catalog
field or attribute		 CDF works field Examples
id (attribute) ID

EMBER Example

id="MV123"

CDF Example

<ID>MV123</ID>
version (attribute) N/A

EMBER Example

version="1"
edit (attribute) N/A

EMBER Example

edit="DIRECTORSCUT,UNRATED"
action (attribute) N/A

EMBER Example

action="upsert"
ExternalIds ExternalID

EMBER Example

<ExternalIds>
  <ExternalId scheme="imdb">tt0076759</ExternalId>
</ExternalIds>

CDF Example

<ExternalID scheme="imdb">tt0076759</ExternalID>
Titles Titles

EMBER Example

<Titles>
    <Title language="en" default="true">The Avengers</Title>
    <Title language="en" territories="GB">Marvel Avengers Assemble</Title>
    <Title language="es">Los Vengadores</Title>
    <Title language="es" territories="CO,EC,ES,UR">Los Vengadores</Title>
</Titles>

CDF Example

<Titles>
    <Title locale="en-US">The Avengers</Title>
    <Title locale="en" territories="GB">Marvel Avengers Assemble</Title>
    <Title locale="es">Los Vengadores</Title>
    <Title locale="es" territories="CO,EC,ES,UR">Los Vengadores</Title>
</Titles>
Descriptions ShortDescriptions

EMBER Example

<Descriptions>
    <Description language="en" territories="US" default="true">
       An all-star ensemble cast of established superheros from the Marvel Comics portfolio.
    </Description>
</Descriptions>

CDF Example

<ShortDescriptions>
    <ShortDescription locale="en-US" territories="US"> 
       An all-star ensemble cast of established superheros from the Marvel Comics portfolio.
    </ShortDescription>
</ShortDescriptions>
Synopses Synopses

EMBER Example

<Synopses>
    <Synopsis language="en" territories="US" default="true">
        Earth's mightiest heroes must come together and learn to fight as a team if they are going to stop the mischievous Loki and his alien army from enslaving humanity.
    </Synopsis>
</Synopses>

CDF Example

<Synopses>
    <Synopsis locale="en-US" territories="US, CA">
         Earth's mightiest heroes must come together and learn to fight as a team if they are going to stop the mischievous Loki and his alien army from enslaving humanity.
    </Synopsis>
</Synopses>
Images Images

EMBER Example

<Images>
    <Image category="cover" language="en" territories="US" aspectRatio="16:9" resolution="HD"
        mimeType="image/jpeg" version="1648485183">https://i.ytimg.com/vi/4DEMG6ulA4o/maxresdefault.jpg
    </Image>
    <Image category="background" territories="US" aspectRatio="16:9" resolution="HD"
        mimeType="image/jpeg" version="1648485183">https://i.ytimg.com/vi/4DEMG6ulA4o/maxresdefault.jpg
    </Image>
</Images>

CDF Example

<Images>
    <Image territories="VI,GU,PR,GB">
      <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_aa.jpg</Url>
      <Locale>en</Locale>
    </Image>
    <Image territories="US">
      <Url>http://amzf.tmsimg.com/assets/28873/p28873_k_h2_haa.jpg</Url>
      <Locale>en</Locale>
    </Image>
</Images>
Genres Genres

EMBER Example

<Genres>
    <!-- Use scheme attribute for specific genre enum values -->
    <Genre scheme="ember_genre">ember_genre_action</Genre>
    <!-- Skip scheme attribute for free form text -->
    <Genre language="en">action</Genre>
</Genres>

CDF Example

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>
Keywords N/A

EMBER Example

<Keywords>
    <Keyword language="en" territories="US">marvel</Keyword>
</Keywords>
Ratings ContentRatings, IsAdultProducts

EMBER Example

<Ratings>
    <Rating territories="AU" system="NCS" certification="M" adultProduct="false" notRated="false">
        <Descriptors>
            <Descriptor code="FV">Fantasy Violence</Descriptor>
            <Descriptor code="CH">Crude Humor</Descriptor>
        </Descriptors>
    </Rating>
</Ratings>

CDF Example

<ContentRatings>
  <ContentRating territories="US,PR,VI">
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

<IsAdultProducts>
  <!-- if no territory is provided, then the field value is applicable worldwide. -->
  <IsAdultProduct>false</IsAdultProduct>
  <IsAdultProduct territories="IN,DE">true</IsAdultProduct>
</IsAdultProducts>
Studios Studios

EMBER Example

<Studios>
    <Studio>
        <StudioNames>
            <StudioName>Metro-Goldwyn-Mayer (MGM)</StudioName>
        </StudioNames>
    </Studio>
</Studios>

CDF Example

<Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
</Studios>
Credits Credits

EMBER Example

<Credits>
   <Credit>
      <PersonNames><PersonName>Rachel Brosnahan</PersonName></PersonNames>
      <ContributionNames>
        <ContributionName>Actor</ContributionName>
      </ContributionNames>
      <CharacterNames>
        <CharacterName language="en" territories="GLOBAL" default="true">Midge Maisel</CharacterName>
      </CharacterNames>
   </Credit>
   <Credit>
      <PersonNames><PersonName>Amy Sherman-Palladino</PersonName></PersonNames>
      <ContributionNames><ContributionName>Producer</ContributionName></ContributionNames>
   </Credit>
   <Credit>
      <PersonNames><PersonName>Lawrence Peter "Yogi" Berra</PersonName></PersonNames>
      <ContributionNames><ContributionName>Coach</ContributionName></ContributionNames>
   </Credit>
</Credits>

CDF Example

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>
Tags N/A

EMBER Example

<Tags>
    <Tag scheme="PrimeVideo" key="JAB_Rights">None</Tag>
    <Tag scheme="PrimeVideo" key="TTL">2025-06-01</Tag>
</Tags>
RunLengths Runtimes

EMBER Example

<RunLengths>
    <RunLength territories="GLOBAL">PT30M</RunLength> 
    <RunLength language="es" territories="MX">PT25M</RunLength>
</RunLengths>

CDF Example

<Runtimes>
    <RuntimeMinutes territories="VI,GU,PR,GB">37</RuntimeMinutes>
    <RuntimeMinutes territories="US">46</RuntimeMinutes>
</Runtimes>
PictureColor Color

EMBER Example

<PictureColor>color</PictureColor>

CDF Example

<Color>black_and_white</Color>
ReleaseDates ReleaseYear, ReleaseDates, OriginalAirDates

EMBER Example

<ReleaseDates>
    <ReleaseDate>2020-05-14</ReleaseDate>
    <ReleaseDate territories="US" releaseType="theater">2020-05-14</ReleaseDate>
</ReleaseDates>

CDF Example

<ReleaseYear>1959</ReleaseYear>

<ReleaseDates>
    <ReleaseDate territories="US,CA">2012-05-13T00:00:00</ReleaseDate>
</ReleaseDates>

<OriginalAirDates>
    <OriginalAirDate territories="US,CA">2014-01-01T11:30:00+08:00</OriginalAirDate>
</OriginalAirDates>
Relationships ShowID, ShowTitle, SeasonID, SeasonTitle, SeasonInShow, EpisodeInSeason, RelatedtoID, RelatedToExternalID

EMBER Example

<!-- Example 1: TV season -->
<TVSeason ...>
    <Relationships>
        <isSeasonOfSeries programRef="SERIES_ID" seasonNum="1"/>
    </Relationships>
</TVSeason>

<!-- Example 2: TV episode with season (traditional TV series) -->
<TVEpisode ...>
    <Relationships>
        <isEpisodeOfSeason programRef="SEASON_ID" episodeNum="5"/>
        <isEpisodeOfSeries programRef="SERIES_ID" episodeNum="5"/>
    </Relationships>
</TVEpisode>

<!-- Example 3: TV episode without season  -->
<TVEpisode ...>
    <Relationships>
        <isEpisodeOfSeries programRef="SERIES_ID" episodeNum="5" />
    </Relationships>
</TVEpisode>

<!-- Example 4: Extras -->
<Relationships>
  <isExtraOf programRef="tt0241527" orderNum="1"/>
</Relationships>

<!-- Example 5: General related content -->
<Relationships>
  <isRelatedTo programRef="tt0241527"/>
</Relationships>

CDF Example

<ShowID>TV-2329880</ShowID>
<ShowTitle locale="en-US">Depth of Field</ShowTitle>
<SeasonInShow>2</SeasonInShow>
<SeasonID>SEA-2329880</SeasonID>
<SeasonInShow>2</SeasonInShow>
<SeasonTitle locale="en-US">Season 2</SeasonTitle>
<EpisodeInSeason>6</EpisodeInSeason>
<RelatesToID>TV123456</RelatesToID>
<RelatesToExternalID scheme="imdb">tt0000000</RelatesToExternalID>
Venue N/A

EMBER Example

<Venue>
    <VenueNames>
        <VenueName language="en" default="true">Los Angeles Memorial Coliseum</VenueName>
        <VenueName language="es">Coliseo Memorial de Los Ángeles</VenueName>
    </VenueNames>
    <Address>
      <Street>3911 S. Figueroa St.</Street>
      <City>Los Angeles</City>
      <StateOrProvince>California</StateOrProvince>
      <Country>United States</Country>
      <PostalCode>90037</PostalCode>
    </Address>
</Venue>
Sports N/A

EMBER Example

<Sports>
    <Sport>
        <SportNames>
            <SportName language="en" territories="GLOBAL">Football</SportName>
            <SportName language="en" territories="US">Soccer</SportName>
        </SportNames>
    </Sport>
</Sports>
Leagues N/A

EMBER Example

<Leagues>
    <League>
        <LeagueNames>
            <LeagueName language="en" default="true">National Football League</LeagueName>
            <LeagueName language="en" territories="US">NFL</LeagueName>
        </LeagueNames>
    </League>
</Leagues>
Season N/A

EMBER Example

<Season>
    <SeasonNames>
        <!-- Year -->
        <SeasonName language="en" default="true">2023</SeasonName>
        <!-- Year 1 and 2 -->
        <SeasonName language="en" default="true">2023-24</SeasonName>
        <!-- Season number -->
        <SeasonName language="en" default="true">57</SeasonName>
    </SeasonNames>
 </Season>
Tournament N/A

EMBER Example

<Tournament>
    <TournamentNames>
        <TournamentName language="fr" default="true">Coupe du monde de football</TournamentName>
        <TournamentName language="en" territories="GLOBAL">FIFA World Cup</TournamentName>
        <TournamentName language="en" territories="US">FIFA Soccer World Cup</TournamentName>
    </TournamentNames>
</Tournament>
Round N/A

EMBER Example

<Round>
    <RoundNames>
        <RoundName language="en" default="true">Quarterfinals</RoundName>
        <RoundName language="es">Cuartos de final</RoundName>
    </RoundNames>
</Round>
Teams N/A

EMBER Example

<Teams>
    <Team homeTeam="true">
        <TeamNames>
            <TeamName language="en" default="true">Chicago Bears</TeamName>
            <TeamName language="en" territories="US">Bears</TeamName>
        </TeamNames>
    </Team>
    <Team>
        <TeamNames>
            <TeamName language="en" default="true">Pittsburgh Steelers</TeamName>
            <TeamName language="en" territories="US">Steelers</TeamName>
        </TeamNames>
    </Team>
</Teams>
Players N/A

EMBER Example

<Players>
    <Player>
        <PlayerNames>
            <PlayerName>Roger Federer</PlayerName>
        </PlayerNames>
    </Player>
</Players>
Gender N/A

EMBER Example

<Gender>
    <GenderNames>
        <GenderName language="en" territories="GLOBAL" default="true">Mens</GenderName>
        <GenderName language="es" territories="MX">Hombres</GenderName>
    </GenderNames>
</Gender>
Format N/A

EMBER Example

<Format>
   <FormatNames>
         <FormatName language="en" default="true">Singles</FormatName>
         <FormatName language="es">Solteros</FormatName>
   </FormatNames>
</Format>
EventDateTime N/A

EMBER Example

<EventDateTime>2020-05-14T13:20:00Z</EventDateTime>
category
(attribute for Extra)		 Type

EMBER Example

category="trailer"

CDF Example

<Type>clip</Type>
N/A Copyright

CDF Example

<Copyright locale="en-US">© 2014 Amazon Studios</Copyright>

Offer catalog

EMBER uses the OfferCatalog element to contain metadata that defines how users can access and discover content. In CDF, offer metadata is contained directly within program and station elements. The following table maps EMBER attributes and elements to CDF elements.

EMBER field
or attribute		 CDF works field Examples
id (attribute) ID

EMBER Example

id="MV123"

CDF Example

<ID>MV123</ID>
version (attribute) N/A

EMBER Example

version="1"
action (attribute) N/A

EMBER Example

action="upsert"
ProgramOffers Offers

EMBER Example

<ProgramOffers id="OFFER123" version="1" programRef="MOVIE123">
    <ProgramOffer>
        <Entitlements>
            <Entitlement type="free"/>
            <Entitlement policyRef="PREMIUM_123"/>
        </Entitlements>
        <AudioLanguages>
            <AudioLanguage language="en" default="true"/>
            <AudioLanguage language="es" original="false">audio descriptivo</AudioLanguage>
        </AudioLanguages>
        <SubtitleLanguages>
            <SubtitleLanguage language="en" closed="true" default="true"/>
            <SubtitleLanguage language="es" closed="true"/>
        </SubtitleLanguages>
        ...        
        <GeoRestrictions>
            <GeoRestriction policyRef="POLICY_123"/>
        </GeoRestrictions>
        <LaunchTargets>
            <LaunchTarget type="FIRETV">amzn://apps/watch?id=123</LaunchTarget>
        </LaunchTargets>
    </ProgramOffer>
</ProgramOffers>

CDF Example

<Offers>
  <FreeOffer>
    <Regions>
      <Territories>US, PR, VI, GB, DE</Territories>
    </Regions>
    <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
    <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
    <LaunchDetails>
      <Quality>SD</Quality>
    </LaunchDetails>
  </FreeOffer>
  <SubscriptionOffer>
    <Regions>
      <Territories>CA</Territories>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>
StationOffers Offers

EMBER Example

<StationOffers id="OFFER123" version="1" stationRef="STATION_ABC">
    <StationOffer >
        <Entitlements>
            <Entitlement type="subscription"/>
        </Entitlements>
        <AudioLanguages>
            <AudioLanguage language="en" default="true"/>
        </AudioLanguages>
        <VideoResolutions>
            <VideoResolution>HD</VideoResolution>
        </VideoResolutions>
        <GeoRestrictions>
            <GeoRestriction policyRef="POLICY_123"/>
        </GeoRestrictions>
        <LaunchTargets>
            <LaunchTarget type="FIRETV">amzn://apps/watch?id=123</LaunchTarget>
        </LaunchTargets>
        <StationTransport channelnum="7" subsystem="ATSC" onid="1" tsid="2" sid="3"/>
    </StationOffer>
</StationOffers>

CDF Example

<Offers>
  <FreeOffer>
    <Regions>
      <Territories>US, PR, VI, GB, DE</Territories>
    </Regions>
    <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
    <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
    <LaunchDetails>
      <Quality>SD</Quality>
    </LaunchDetails>
  </FreeOffer>
  <SubscriptionOffer>
    <Regions>
      <Territories>CA</Territories>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>
ProgramAiringOffers N/A

EMBER Example

<ProgramAiringOffers id="OFFER123" version="1" programRef="PROG_123">
    <ProgramAiringOffer>
        <Airing id="AIRING_123" 
                startTime="2025-02-28T15:00:00Z" 
                duration="PT2H" 
                programRef="PROG_123">
            <Live/>
            <New/>
            <AudioLanguages>
                <AudioLanguage language="en" default="true"/>
            </AudioLanguages>
        </Airing>
        <Entitlements>
            <Entitlement type="free"/>
        </Entitlements>
        <VideoResolutions>
            <VideoResolution>HD</VideoResolution>
        </VideoResolutions>
    </ProgramAiringOffer>
</ProgramAiringOffers>
ProgramDiscovery MetadataAvailabilityDates, CustomerRating, Rank, IsOriginals

EMBER Example

<ProgramDiscovery start="2020-05-14T12:00:00Z"
           end="2020-05-14T15:00:00Z"
           territories="US" programRef="PROG_123">
    <!-- Discovery start/end times indicate when the program/station can be discovered on the Fire TV UI -->

    <Ranks>
        <Rank territories="US" value="10"/>
    </Ranks>

    <CustomerRatings>
        <CustomerRating score="4.9" maxScore="5" numVotes="10000" sourceName="imdb" sourceDate="2023-12-21"/>
    </CustomerRatings>

    <!-- values for ember_badge scheme : original, new, premiere, finale, coming_soon, leaving_soon -->
    <Badges>
        <!-- example with scheme -->
        <Badge scheme="ember_badge">original</Badge>
        <!-- example with free form text -->
        <Badge>coming_soon</Badge>
    </Badges>
    
</ProgramDiscovery>

CDF Example

<MetadataAvailabilityDates>
    <!-- Movie available in US, CA and GB on Sep 1, while rest of the territories on Sep 15 -->
    <MetadataAvailabilityDate>2021-09-15T12:00:00Z</MetadataAvailabilityDate>
    <MetadataAvailabilityDate territories="US,CA,GB">2021-09-01T12:00:00Z</MetadataAvailabilityDate>
 </MetadataAvailabilityDates>

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

<Rank>36</Rank>

<IsOriginals>
  <!-- For worldwide originality of an item, use the IsOriginal child element without the territories attribute. -->
  <IsOriginal>true</IsOriginal>
  <!-- If the same content shouldn't be a provider original in US and CA, then add the additional element, below  -->
  <IsOriginal territories="US,CA">false</IsOriginal>
</IsOriginals>
original
(attribute for AudioLanguage)		 Language

EMBER Example

<AudioLanguage language="en" original="true"/>

CDF Example

<Language>en</Language>

Station catalog

EMBER uses the StationCatalog element to contain metadata that defines the customer-facing and management attributes of a station or channel. The following table maps EMBER attributes and elements to CDF elements.

EMBER field
or attribute		 CDF works field Examples
id (attribute) ID

EMBER Example

id="STA123"

CDF Example

<ID>STA123</ID>
version (attribute) N/A

EMBER Example

version="1"
action (attribute) N/A

EMBER Example

action="upsert"
ExternalIds ExternalID

EMBER Example

<ExternalIds>
  <ExternalId scheme="imdb">tt0076759</ExternalId>
</ExternalIds>

CDF Example

<ExternalID scheme="imdb">tt0076759</ExternalID>
Titles Titles

EMBER Example

<Titles>
    <Title language="en">CBS News Seattle</Title>
</Titles>

CDF Example

<Titles>
    <Title locale="en">CBS News Seattle</Title>
</Titles>
Images Images

EMBER Example

<Images>
    <Image category="cover" language="en" territories="US" aspectRatio="16:9" resolution="HD"
        mimeType="image/jpeg" version="1648485183">https://example.com/cover.jpg
    </Image>
    <Image category="logo" territories="US" aspectRatio="16:9" resolution="HD"
        mimeType="image/png" version="1648485183">https://example.com/logo.png
    </Image>
</Images>

CDF Example

<Images>
    <Image>
        <Url>https://example.com/station_cover.jpg</Url>
        <Tag>stationCover</Tag>
        <Locale>en-US</Locale>
    </Image>
    <Image>
        <Url>https://examples/station_hb.jpg</Url>
        <Tag>stationHB</Tag>
        <Locale>en-US</Locale>
    </Image>
</Images>
CallSign CallSign

EMBER Example

<CallSign>CBS</CallSign>

CDF Example

<CallSign>CBS</CallSign>
Descriptions N/A

EMBER Example

<Descriptions>
    <Description language="en" territories="US" default="true">
       An all-star ensemble cast of established superheros from the Marvel Comics portfolio.
    </Description>
</Descriptions>
Genres N/A

EMBER Example

<Genres>
    <!-- Use scheme attribute for specific genre enum values -->
    <Genre scheme="ember_genre">ember_genre_action</Genre>
    <!-- Skip scheme attribute for free form text -->
    <Genre language="en">action</Genre>
</Genres>
Tags N/A

EMBER Example

<Tags>
    <Tag scheme="PrimeVideo" key="JAB_Rights">None</Tag>
    <Tag scheme="PrimeVideo" key="TTL">2025-06-01</Tag>
</Tags>
StationCategory N/A

EMBER Example

<StationCategory scheme="ember_category">ember_category_news</StationCategory>
OriginalBroadcastType StationType

EMBER Example

<OriginalBroadcastType>Full Power Broadcast</OriginalBroadcastType>

CDF Example

<StationType>Network</StationType>
AffiliatedNetworks StationAffiliateInfo

EMBER Example

<AffiliatedNetworks>
   <AffiliatedNetwork>CBS</AffiliatedNetwork>
</AffiliatedNetworks>

CDF Example

<StationAffiliateInfo>
    <ParentAffiliate>
        <Affiliate>
            <Type>Network</Type>
            <AffiliateID>CBS</AffiliateID>
        </Affiliate>
     </ParentAffiliate>
</StationAffiliateInfo>
VideoResolutions StationAttributes

EMBER Example

<VideoResolutions>
    <VideoResolution>SD</VideoResolution>
    <VideoResolution>HD</VideoResolution>
</VideoResolutions>

CDF Example

<StationAttributes>
    <StationAttribute>HDTV</StationAttribute>
</StationAttributes>
Ratings N/A

EMBER Example

<Ratings>
    <Rating territories="AU" system="NCS" certification="M" adultProduct="false" notRated="false">
        <Descriptors>
            <Descriptor code="FV">Fantasy Violence</Descriptor>
            <Descriptor code="CH">Crude Humor</Descriptor>
        </Descriptors>
    </Rating>
</Ratings>
AudioLanguages BroadcastLanguage

EMBER Example

<AudioLanguages>
   <AudioLanguage language="en" default="true"/>
   <AudioLanguage language="es">audio descriptivo</AudioLanguage>
</AudioLanguages>

CDF Example

<BroadcastLanguage>en</BroadcastLanguage>
SubtitleLanguages N/A

EMBER Example

<SubtitleLanguages>
    <SubtitleLanguage language="en" closed="true" default="true"/>
    <SubtitleLanguage language="en" closed="true">director's commentary</SubtitleLanguage>
</SubtitleLanguages>
N/A TimeZone

CDF Example

<TimeZone>America/Los Angeles</TimeZone>

Schedule catalog

EMBER uses the ScheduleCatalog element to contain metadata for airing schedules. The following table maps EMBER attributes and elements to CDF elements.

EMBER field
or attribute		 CDF works field Examples
id (attribute) ID

EMBER Example

id="SCH123"

CDF Example

<ID>SCH123</ID>
version (attribute) N/A

EMBER Example

version="1"
action (attribute) N/A

EMBER Example

action="upsert"
Schedule ScheduleDay

EMBER Example

<Schedule id="linear_Feb1" 
        version="1"
        date="2025-02-28"
        stationRef="CBS123" 
        stationCatalogRef="STA_CAT123" 
        programCatalogRef="PRO_CAT123">
          
    <Airing id="movie123"...>
      ...
    </Airing>
    <Airing id="movie234"...>
      ...
    </Airing>
</Schedule>

CDF Example

<ScheduleDay>
  <ID>station-example-2024-10-01</ID>
  <Date>2024-10-01</Date>
  <AssociatedStationId>station123</AssociatedStationId>
  <Schedules>
    <Schedule>
      <ContentReference>movie123</ContentReference>
      <StartTime>2024-10-01T18:00:00</StartTime>
      <Duration>PT120M</Duration>
      <PreferredLocale>en-US</PreferredLocale>
      <SubtitleLanguage>en-US</SubtitleLanguage>
    </Schedule>
  </Schedules>
</ScheduleDay>
Airing Schedule

EMBER Example

<Airing id="movie123" 
      startTime="2025-02-28T15:00:00Z" 
      duration="PT30M" 
      programRef="PID123">

   <Live/>
   <New/>
   <Edited ...>
   <Ratings> ...
   <AudioLanguages> ... 
   <SubtitleLanguages> ... 
   <Tags> ...
   <GeoRestrictions> ...
</Airing>

CDF Example

<Schedule>
  <ContentReference>abc123</ContentReference>
  <StartTime>2023-01-01T12:00:00</StartTime>
  <Duration>PT30M</Duration>
  <BlackoutInformation>
    <BlackoutApplicable>true</BlackoutApplicable>
    <BlackoutRegion>
      <PostalCode>
        <AssociatedCountry>US</AssociatedCountry>
        <Values>
          <Value>98109</Value>
        </Values>
      </PostalCode>
      <FilterType>INCLUDE</FilterType>
    </BlackoutRegion>
  </BlackoutInformation>
  <PreferredLocale>en-US</PreferredLocale>
  <SubtitleLanguage>en</SubtitleLanguage>
  <DubbedLanguage>es</DubbedLanguage>
  <SAPLanguage>fr</SAPLanguage>
  <TvRating>
    <ContentRating>
      <System>MPAA</System>
      <Certification>PG-13</Certification>
    </ContentRating>
  </TvRating>
  <ScheduleAttributes>
    <ScheduleAttribute>New</ScheduleAttribute>
  </ScheduleAttributes>
</Schedule>
Live ScheduleAttributes

EMBER Example

<Live/>

CDF Example

<ScheduleAttributes>
  <ScheduleAttribute>Live</ScheduleAttribute>
</ScheduleAttributes>
New ScheduleAttributes

EMBER Example

<New/>

CDF Example

<ScheduleAttributes>
  <ScheduleAttribute>New</ScheduleAttribute>
</ScheduleAttributes>
Edited N/A

EMBER Example

<Edited cropped="true"/>
Ratings TvRating

EMBER Example

<Ratings>
    <Rating territories="AU" system="NCS" certification="M" adultProduct="false" notRated="false">
        <Descriptors>
            <Descriptor code="FV">Fantasy Violence</Descriptor>
            <Descriptor code="CH">Crude Humor</Descriptor>
        </Descriptors>
    </Rating>
</Ratings>

CDF Example

<TvRating>
    <ContentRating>
      <System>MPAA</System>
      <Certification>PG-13</Certification>
    </ContentRating>
</TvRating>
AudioLanguages PreferredLocale, DubbedLanguage, SAPLanguage

EMBER Example

<AudioLanguages>
   <AudioLanguage language="en" default="true"/>
   <AudioLanguage language="es">audio descriptivo</AudioLanguage>
</AudioLanguages>

CDF Example

<PreferredLocale>en-US</PreferredLocale>
<DubbedLanguage>es</DubbedLanguage>
<SAPLanguage>fr</SAPLanguage>
SubtitleLanguages SubtitleLanguage

EMBER Example

<SubtitleLanguages>
    <SubtitleLanguage language="en" closed="true" default="true"/>
    <SubtitleLanguage language="en" closed="true">director's commentary</SubtitleLanguage>
</SubtitleLanguages>

CDF Example

<SubtitleLanguage>en</SubtitleLanguage>
Tags N/A

EMBER Example

<Tags>
    <Tag scheme="PrimeVideo" key="JAB_Rights">None</Tag>
    <Tag scheme="PrimeVideo" key="TTL">2025-06-01</Tag>
</Tags>
GeoRestrictions BlackoutInformation

EMBER Example

<GeoRestrictions>
    <GeoRestriction policyRef="Audience_Policy_123"/>
</GeoRestrictions>

CDF Example

<BlackoutInformation>
  <BlackoutApplicable>true</BlackoutApplicable>
  <BlackoutRegion>
    <PostalCode>
      <AssociatedCountry>US</AssociatedCountry>
      <Values>
        <Value>98109</Value>
      </Values>
    </PostalCode>
    <FilterType>INCLUDE</FilterType>
  </BlackoutRegion>
</BlackoutInformation>

Lineup catalog

EMBER uses the LineupCatalog element to contain metadata for channel lineup definitions. The following table maps EMBER attributes and elements to CDF elements.

EMBER field
or attribute		 CDF works field Examples
id (attribute) ID

EMBER Example

id="LIN123"

CDF Example

<ID>LIN123</ID>
version (attribute) N/A

EMBER Example

version="1"
name (attribute) Name

EMBER Example

name="Seattle Cable Lineup"

CDF Example

<Name>Seattle Cable Lineup</Name>
broadcastType (attribute) BroadcastType

EMBER Example

broadcastType=cable

CDF Example

<BroadcastType>cable</BroadcastType>
mso (attribute) MSO

EMBER Example

mso="Seattle Cable Company"

CDF Example

<MSO>Seattle Cable Company</MSO>
action (attribute) N/A

EMBER Example

action="upsert"
ExternalIds ExternalID

EMBER Example

<ExternalIds>
  <ExternalId scheme="imdb">tt0076759</ExternalId>
</ExternalIds>

CDF Example

<ExternalID scheme="imdb">tt0076759</ExternalID>
Channels Broadcasts

EMBER Example

<Channels>
  <Channel id="BC123" stationRef="STA123">
    <StationTransport channelnum="001" subsystem="DVB-C" onid="O_123" tsid="T_123" sid="S_123"/>
  </Channel>
  <Channel id="BC345" stationRef="STA345">
    <StationTransport channelnum="002" subsystem="DVB-C" onid="O_345" tsid="T_345" sid="S_345"/>
  </Channel>
</Channels>

CDF Example

<Broadcasts>
        <Broadcast>
            <ID>broadcast-example1</ID>
            <StationReference>station-example1</StationReference>
            <Channel>3</Channel>
            <Transports>
                <Transport subsystem="DVB_T">
                    <ONID>12339</ONID>
                    <TSID>8197</TSID>
                    <SID>8261</SID>
                    <Country>US</Country>
                </Transport>
            </Transports>
        </Broadcast>
        ...
    </Broadcasts>
GeoRestrictions LocationInfo

EMBER Example

<GeoRestrictions>
    <GeoRestriction policyRef="Audience_Policy_123"/>
</GeoRestrictions>

CDF Example

<LocationInfo>
        <Region>
            <PostalCodes>
                <PostalCode>
                    <AssociatedCountry>US</AssociatedCountry>
                </PostalCode>
            </PostalCodes>
        </Region>
        <FilterType>EXCLUDE</FilterType>
</LocationInfo>

Last updated: May 27, 2026

Follow us:
amazon_developer_logo

© 2010-2026, Amazon.com, Inc. or its affiliates. All Rights Reserved.

Terms

Amazon Developer Blog

Contact Us