Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Devices
Build
Test
Publish
Connect
Documentation
Skip to main content
This topic provides a dictionary of the elements available in the Catalog Data Format (CDF) schema, which is used to construct a catalog of your media content for upload to Amazon Fire TV.

CDF schema

The Catalog Data Format (CDF) schema defines the required elements to describe your media so that Amazon can integrate your catalog. The schema is defined in the catalog.xsd file. The schema contains more than 150 elements used for different types of media, such as movies, TV shows, broadcasts, and more. You can download the catalog.xsd file below: You can view the Catalog schema documentation in two ways:
  • Element-filtered Web Pages. The web pages show diagrams and code samples that reflect the element hierarchy, parent-children requirements, and other content model details.
  • View the XSD file directly. This XSD file provides a technical representation of the content.
The video below provides a walkthrough on creating catalogs with CDF:

Element-filtered web pages

You can view the schema elements in the CDF documentation. Although you can view all elements in a flat list, it might be more helpful to select a common parent element (such as Movie) and look at the diagram for that element.
Web page with filtered elements

Web page with filtered elements

When you click an element in the diagram, a description of that element scrolls into focus below the diagram. The elements with diagram pages are as follows:

View the XSD file directly

You can also view the catalog.xsd file directly in an XML editor for more enhanced navigation controls. You can also read the XSD file directly to learn the schema logic. If you’re new to XSD files, see XML Schema Part 0: Primer Second Edition for an introduction. More formal reference documentation for the XSD schema is available at XML Schema Part 1: Structures Second Edition and XML Schema Part 2: Datatypes Second Edition. Here are a few tips on reading XSD files:
XSD propertyWhat it means
xsd:elementIdentifies an element
minOccurs="0"The element is optional
maxOccurs="unbounded"The element can be repeated an unlimited number of times.
xsd:simpleTypeThe element does not have any children or attributes. See simpleType for more details.
xsd:complexTypeThe element either has children or attributes. Complex Types have a content model description that specifies whether the child elements must be sequential, whether the children have either/or requirements, or other logic. See complexType for more details.
xsd:choiceIndicates that you must choose, among the child elements, which one you want to include. The logic is either one element or the other, not all. For example, Credits allows either a CastMember or CrewMember child item, but not both.
xsd:sequenceIndicates that the child elements must follow the specified sequence. For example, CustomerRating requires that the child elements Score, MaxValue, and Count appear in sequential order, with the Count as optional.
xsd:sequence and xsd:choice togetherSome elements use a combination of both sequence and choice together. When this happens, the description for the content model clarifies the usage.
xsd:annotationIndicates documentation for the element. Note that although the catalog XSD file has some annotation elements with each element, the descriptions are brief and not intended as the official documentation. The documentation on the web pages provides the official documentation for the elements. The value of the XSD file is in identifying the content model logic and required usage more than understanding the meaning of each of the elements.
xsd:enumerationAn enum value is allowed for the simpleType’s value. Enums limit the options to a predefined list of strings.
xsd:extension base=The logic for the element builds on another element. This element extends on another element as its base.
xsd:attributeThe element allows attributes. See 2.2 Complex Type Definitions, Element & Attribute Declarations for a description of attributes in XML.

XML data types

Certain data types, such as Strings, Booleans, and Integers, are built directly into the XML schema. Common data types you’ll see in the catalog file are defined in the following table. You can read more details either at the tutorial link or the official w3.org site. (The tutorial link provides a more friendly, readable description of the data type, while the w3.org link provides the official schema reference.)
XML Data TypeDescriptionTutorial LinkW3C Link
booleanA true or false valuexsd:booleanw3.org
decimalA number with a decimal such as 5.2xsd:decimalw3.org
dateA date value in the form of 2019-02-19xsd:booleanw3.org
dateTimeThis value takes the form YYYY-MM-DDThh:mm:ss where YYYY-MM-DD is the year, month, and date and hh:mm:ss is the hour, minute, and second. Example: 2003-08-08T17:18:37. The T separates the two portions. The entire value is required, from the year down to the second. If the time value is unknown to you, simply use 00:00:00. You can also add an offset from UTC to the end of the value to account for a particular time zone.xsd:dateTimew3.org
durationA duration of time written as an expression starting with P and then years, months, days, hours, minutes, seconds. For example, P2Y6M5DT12H35M30S.xsd:durationw3.org
intInteger (a whole number) such as 5xsd:intw3.org
languageA language identifier such as enxsd:languagew3.org
NonEmptyTokenSame as xsd:token but not allowed to be empty.xsd:tokenw3.org
stringAlphanumeric letters and numbersxsd:stringw3.org
string (localized)Same as string but with attributes such as locale and pronunciation that allow for localization.xsd:stringw3.org
tokenSimilar to string but ampersands and angle brackets must be escaped. Any white space is collapsed onto the same line.xsd:tokenw3.org
anyURIA URL such as https://amazon.comxsd:anyURIw3.org

Building your catalog file

For an overview of the structure of a CDF catalog file and how these elements interact, see Step 1: Create Your Catalog File.
Last modified on May 27, 2026