Title metadata files include information like genre, synopsis, and cast and crew, that helps create a customer-facing detail page for each title. Prime Video accepts metadata in both Amazon XML and Amazon XLS formats for the US, UK, DE, and JP territories. For more information on the formats and benefits of each, see below.
A separate metadata file is required for each delivery territory. For specific territory requirements, see the table below. You may redeliver metadata at any time to update metadata values.
Territory-specific XLS templates are available for download.
The table below summarizes the Amazon XLS fields and associated notes. Accepted Values lists the acceptable values or indicates the type of value expected for each field. If left blank, it indicates a string is acceptable. All inputs are limited to UTF-8 characters. Prime Video Usage indicates whether the field is required, optional, or not used by Amazon.
Field Name | Definition & Notes | Accepted Values | Prime Video Usage |
---|---|---|---|
Partner Name | The organization granting rights. Use your Amazon "PartnerAlias" to match to asset packages. Case insensitive. No spaces or symbols. | Required | |
Unique ID | The internal ID for the feature or episode. 50-character limit. Case insensitive. Must be unique within your catalog. Only letters, numbers, and underscores; no spaces or symbols. | Required | |
WorkType | Type of the work. | Movie, TV Series, TV Season, TV Episode | Required |
Title | The title of the feature, series, season, or episode. Must be the localized title. This is the title that will be presented to customers. Use "The Title Name" rather than "Title Name, The". 250-character limit. If this is for season level, then the series name should be included in the season title. A number should also be used to indicate a season. | Required | |
Title pronunciation | Hiragana (ひらがな), katakana (カタカナ) and alphanumeric are accepted. Numbers should be given pronunciation if there is an unusual pronunciation (i.e. 2人=ふたり). English words in the title remain as English in the pronunciation. | Required only for JP | |
Studio | The name of the credited studio. Multiple studio names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. For Television content, this is usually the "Network" the Show aired on (rather than the production company that made or distributed it). For Movies, the Studio(s) that produced the Movie. If none is provided, a content provider name will be applied as studio. | Optional | |
Rating | The approved rating value of the region. Populate with "NR" if rating is not available. | See Prime Video ratings list. | Required for Movie, TV Season, and TV Episode |
Start Year | The year the Series started or the year the first TV Episode was broadcast. | YYYY | Optional for TV Series |
End Year | The year the Series ended or the year the last TV Episode was broadcast. Mostly used for catalog titles that have already ended. For currently running titles, leave blank. | YYYY | Optional for TV Series |
Season Sequence Number | The number of the season. | Integer | Required for TV Season |
Series ID | The internal ID for the series. Must match the TV Series Unique ID or previously-ingested series Unique ID. Only letters, numbers, and underscores; no spaces or symbols. | Required for TV Season and TV Episode | |
Season ID | The internal ID for the season. Must match the TV Season Unique ID or previously-ingested season Unique ID. Only letters, numbers, and underscores; no spaces or symbols. | Required for TV Season | |
Episode Sequence Number | The number of the episode. Episodes should begin with 1 instead of 101; VAM should begin with 0. | Integer | Required for TV Episode |
Episode Production Number | Studio or Network episode production number | Integer | Optional for TV Episode |
Short Synopsis | A description of the content. 400-character limit. Ensure that there are no references to the product being a physical product, describing video quality or price (e.g., DVD, Blu-ray, HD, 3D, Euro). | Required | |
Long Synopsis | A description of the content. 2,000-character limit. Ensure that there are no references to the product being a physical product, describing video quality or price (e.g., DVD, Blu-ray, HD, 3D, Euro). | Optional | |
Actors | Actor(s) in the content. Maximum 100 names (one name per line). Multiple names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. Series and Season Actors should be for the series and season regular actors. For TV Episode content, use the Actors column for guest stars within the episode. 250-character limit per line. Note that the first three actors listed will be the Starring Actors and the remaining will be listed as Supporting Actors. | Optional | |
Directors | Director(s) of the content. Maximum 100 names (one name per line). Multiple names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. 250-character limit per line. | Required for Movie | |
Producers | Producers of the content. Maximum 100 names (one name per line). Multiple names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. Either the production company or the name of individual producers is valid. 250-character limit per line. | Optional | |
Writers | Writer(s) of the content. Maximum 100 names (one name per line). Multiple names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. 250-character limit per line. | Optional | |
Creator | Creator(s) of the content. Maximum 100 names (one name per line). Multiple names should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. 250-character limit per line. | Optional | |
Release Date | The date that a movie or TV episode was first released. Format is YYYY-MM-DD or the cell must be labeled as "Date" in the Number section of the Home ribbon. For a movie, this is the release date. For TV episode, this is the original air date. | YYYY-MM-DD | Required for Movie and TV Episode |
DVDStreetDate | Date of the first physical release of the product or the first time the product was available for public purchase. Format is YYYY-MM-DD or the cell must be labeled as "Date" in the Number section of the Home ribbon. | YYYY-MM-DD | Optional for Movie |
IMDB | The Series/Episode/Movie IMDb ID only. 9-character value assigned by IMDb. Begins with "tt" and is then followed by 7 numbers. | Optional | |
Copyright Holder | Copyright holder for the content. 250-character limit. | Optional | |
Copyright Year | The copyright year of content. | YYYY | Optional |
Language | Language the main audio is in. If dubbed audio is present in the mezzanine, this would represent the language of the dubbed audio. Lowercase values only. | ISO 639-1 language codes | Optional |
OriginalLanguage | Language identified as the original production of the work (i.e. the "OV" language). This is generally the language used for the title treatment and/or credits of the work. Only one lowercase value allowed. | ISO 639-1 language codes | Required |
CountryOfOrigin | The country of origin of the content. Uppercase only. Multiple countries should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. | ISO 3166-1 | Required |
OriginalLanguageTitle | Original language title of the content (a.k.a. titles). 250-character limit. | Optional | |
RuntimeInMinutes | The runtime of the content, in minutes. | Integer | Optional for Movie and TV Episode |
AdultProduct | Is this content intended for an adult audience? | "true" or "false" | Required only for JP |
Genre | The approved Prime Video genre of the content. Case sensitive. Can have up to five genres. Multiple genres should be formatted as one on each line, using Alt+Enter to separate within the cell. No commas, semicolons, etc. | See the Prime Video genre list. | Required for Movie and TV Episode |
Subscription Name | Prime Video-approved "Benefit ID" if content is destined for a third-party subscription (Prime Video Channels). Case sensitive. No spaces or symbols. | Required for third-party subscriptions (Channels) | |
Display Aspect Ratio | Aspect ratio of the video. | 4:3, 1.667:1, 16:9, 1.85:1, 2:1, 2.2:1, 2.35:1, and 2.4:1 | Optional |
Field type | Field type of the video. | "Top Field First" and "Bottom Field First" | Optional |
Territory-specific AmazonXML metadata template files are available for download.
A separate metadata file must be delivered for every territory of intended delivery (US, UK, DE, and JP). The genre lists are unique for each territory and each submission must contain genres for the territory of submission.
Packaging a title for the US territory requires the following packaging specifics in addition to the overall US packaging requirements:
Packaging a title for the UK territory requires the following packaging specifics in addition to the overall UK packaging requirements:
Packaging a title for the DE territory requires the following packaging specifics in addition to the overall DE packaging requirements :
Packaging a title for the JP territory requires the following packaging specifics in addition to the overall JP packaging requirements:
Prime Video supports the delivery of 4K UHD and High Dynamic Range (HDR) titles to all territories. The following section outlines requirements for delivering 4K UHD/HDR titles to the US, UK, DE, and JP territories. You must undergo a specific onboarding process before delivering 4K UHD/HDR titles to Prime Video.
4K UHD/HDR titles in Prime Video US, UK, DE, and JP territories have separate detail pages from their HD/SD counterparts. To facilitate this, we require two unique UniqueIDs and two unique delivery packagesone for the standard SD/HD package and one for the 4K UHD/HDR package.
To support the separate detail pages for 4K UHD/HDR and HD/SD, the 4K UHD/HDR deliveries must have their own UniqueID that is different from the HD/SD version of that title. This Unique ID should be the same as the ID for the HD/SD version of the title, but appended with "_UHD". This ID must be referenced in the avail, the title metadata, and the asset manifest to ensure that all deliveries are appropriately matched.
Type | Title | Unique ID |
---|---|---|
HD/SD | The Marvelous Mrs. Maisel | MrsmaiselS1E1 |
4K UHD | The Marvelous Mrs. Maisel (4K UHD) | MrsmaiselS1E1_UHD |
Type | Title | Unique ID |
---|---|---|
HD/SD | The Marvelous Mrs. Maisel | MrsmaiselS1E1 |
4K UHD OV | The Marvelous Mrs. Maisel [OV] (4K Ultra HD) | MrsmaiselS1E1_UHD |
4K UHD Subtitled | The Marvelous Mrs. Maisel [OmU] (4K Ultra HD) | MrsmaiselS1E1_SUB_UHD |
4K UHD Dubbed | The Marvelous Mrs. Maisel (4K Ultra HD) | MrsmaiselS1E1_DUB_UHD |
Type | Title | Unique ID |
---|---|---|
HD/SD | The Marvelous Mrs. Maisel | MrsmaiselS1E1 |
4K UHD OV | The Marvelous Mrs. Maisel (4K Ultra HD) | MrsmaiselS1E1_UHD |
4K UHD Subtitled | The Marvelous Mrs. Maisel (字幕版) (4K Ultra HD) | MrsmaiselS1E1_SUB_UHD |
4K UHD Dubbed | The Marvelous Mrs. Maisel (字幕版) (4K Ultra HD) | MrsmaiselS1E1_DUB_UHD |
All UHD/HDR titles must have corresponding avails that include 4K or UHD in the Format Profile column. The AltID column for this line must include the Unique ID that is specific to the 4K/UHD version of the title. See additional details on Unique IDs for UHD titles above.
HDR titles must include both an HDR and an SDR video file delivery. The only difference between the SDR and HDR video files should be the colorspace. Otherwise, the files should be identical, including the same resolution and framerate. Any subtitles delivered with a UHD/HDR package should conform to both the SDR and HDR video files.
HDR titles must include both an HDR and an SDR video file delivery. These files are both referenced in the XML Asset Manifest. Additionally, the manifest must include the HDR10 metadata for the HDR video file. Both the HDR and SDR video files are associated to the same UniqueID.
Prime Video will provide the HDR encodes for customers accessing content on HDR enabled screens and will provide the SDR encodes for customers accessing the content on SDR screens. Titles that are only UHD and unavailable in HDR should follow the same delivery process as described above with the omission of the HDR video file. In this case, the manifest will reference only the UHDSDR video file.
Please sign in to continue
Sign In