Asset manifests serve two main purposes.
There are two supported manifest formats in Classic territories.
Each Aspera delivery account only supports one of the two manifest options, but not both simultaneously. Specifics on how to deliver to each option are as follows.
The Amazon Simple Asset Manifest allows partners to deliver an XML file with asset metadata. Audio descriptions and HDR mezzanines must be delivered via XML Metadata. The Simple Asset Manifest includes the ability to use non-conformed file names, provide technical asset details such as frame rate and Drop/Non-Drop Frame values for timed text assets, and the association of a title identifier to each asset. This manifest can be included in the same file as the XML title metadata or be delivered as a separate file. When an asset referenced in the manifest needs to be redelivered, Prime Video requires the new asset file to have a different file name than what was previously referenced. Prime Video prefers you amend the file name with an "R1," "R2," etc. Example files for each of these options can be found in the Sample Files. When delivering Amazon XML files, they are subject to the file naming rules.
If you are currently delivering to File Naming Convention, migration to delivery via the Simple Asset Manifest requires Prime Video to make manual configuration changes to your partner delivery account. If you want to use the Amazon Simple Asset Manifest, please contact your Operations Account Manager for details.
Amazon XML templates are available for both individual territories (US, UK, DE, and JP) as well as content types (TV or movie). While there are differences based on territory and content type across these templates, the table below lists all the Amazon XML fields and associated notes. Amazon XML templates are available for download in the Sample Files. Accepted Values lists the acceptable inputs 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 Prime Video.
Field Name | Definition & Notes | Accepted Values | Prime Video Usage |
---|---|---|---|
AmazonXML-Type | Use the applicable territory's Movie template for stand-alone content and the applicable territory's TV template for episodic content. | Required | |
Movie/Series/ Season/Episode | Required | ||
PartnerName | The organization granting rights. Use your Amazon PartnerAlias to match to asset packages. Case insensitive. No spaces or symbols. | Required | |
UniqueID | The internal ID for the feature or episode. 50-character limit. Case insensitive. Should be unique within your catalog. Only letters, numbers, and underscores; no spaces or symbols. | Required | |
IMDb | The Series/Episode/Movie IMDb ID only. Nine-character value assigned by IMDb. Begins with tt and is then followed by seven numbers. | Optional | |
ExternalID | Alternate identifiers that can be used to identify the title. For multiples, add a new ExternalID line for each value. | Optional for Movie | |
Scheme | The scheme of the External ID (EIDR, ISAN, etc.). | Required for External ID | |
CopyrightHolder | Copyright holder for the content. 250-character limit. | Optional | |
CopyrightYear | 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. Lower-case values only. | ISO 639-1 language codes | Optional |
OriginalLanguage | Original language of the content. Lower case values only. | ISO 639-1 language codes | Optional |
CountryOfOrigin | The country of origin of the content. Upper case only. For multiples, add a new CountryOfOrigin line for each value. | ISO 3166-1 | Optional |
SeriesID | The internal ID for the series. Must match the series Unique ID from the corresponding Series section of XML or previously-ingested series Unique ID. | Required for Season and Episode | |
SeasonID | The internal ID for the series. Must match the series Unique ID from the corresponding Season section of XML or previously-ingested season Unique ID. | Required for Episode | |
RuntimeInMinutes | The runtime of the content, in minutes. | Integer | Optional |
AdultProduct | Is this content intended for an adult audience? | "true" and "false" | Required only in JP for Season and Episode |
TitleInfo | Information about the content. | Required | |
Sequence | The season number or episode number. The order in which the season will appear within the series or the order in which the episode will appear within the season. Begin this sequence with 1 instead of 101. | Integer | Required for Season and Episode |
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. | Required | |
Locale | The locale of the territory. For US, use locale en-US; for UK, use locale en-GB; for Germany, use locale de-DE; and for JP, use locale ja-JP. | Required | |
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 in JP | |
Synopses | A description of the content. 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 | |
Short | 400-character limit. | Required | |
Long | 2,000-character limit. | Optional | |
Actor | Actor(s) in the content. Series and Season actors should be for the series and season regular actors. 250-character limit. At least one of Actor, Producer, or Director must be included. | Optional for Movie, Series, and Season. | |
ActorName | For multiples, add a new Actor and ActorName section for each. | Required for Actor | |
Character | For multiples, add a new Character per Actor and ActorName. | Optional for Actor | |
GuestActor | Guest actor(s) in the episode. For TV, regular series and season actors should be added to the Actor section. 250-character limit. | Optional for Episode | |
GuestActorName | For multiples, add a new GuestActor and GuestActorName section for each. | Required for GuestActor | |
Character | For multiples, add a new Character per GuestActor and GuestActorName. | Optional for GuestActor | |
Director | Director(s) of the content. For multiples, add a new Director line for each value. 250-character limit. At least one of Actor, Producer, or Director must be included. | Required for Movie | |
Producer | Producer(s) of the content. For multiples, add a new Producer line for each value. 250-character limit. At least one of Actor, Producer, or Director must be included. | Optional | |
Writer | Writer(s) of the content. For multiples, add a new Writer line for each value. 250-character limit. | Optional | |
Creator | Creator(s) of the content. For multiples, add a new Creator line for each value. 250-character limit. | Optional | |
Studio | Studio(s) that produced the content. For Television content, this is usually the network the show aired on. For multiples, add a new Studio line for each value. 250-character limit. | Optional | |
ItemType | Defines the type of content in Prime Video systems. | downloadable-feature-films and downloadable-television-shows | Optional for Movie and Episode |
ReleaseDate | The date that a movie was first released. Theatrical release date or date of first public availability for straight-to-video or web content titles. | YYYY-MM-DDT00:00:00 | Required for Movie |
DVDStreetDate | Date of the first physical release of the product or the first time the product was available for public purchase. | YYYY-MM-DDT00:00:00 | Optional for Movie |
Start Year | The year the TV Series started or the year the first TV Episode was broadcast. | YYYY | Optional for Series |
End Year | The year the TV Series ended or the year the last TV Episode was broadcast. Mostly used for catalog titles that have already ended. For currently-running titles, delete this entire row. | YYYY | Optional for Series |
Genre | The approved Prime Video genre of the content. Case sensitive. Five Genre values maximum. For multiples, add a new Genre line for each value. | See the Prime Video genre list. | Required for Movie and Episode |
Rating | The approved rating value of the applicable region. Populate with NR if rating is not available. A scheme is required (bbfc, fsk, eirin, etc.) | See the Prime Video ratings list. | Required for Movie Season, and Episode |
Offer | Optional | ||
PartnerName | The organization granting rights. Use your Amazon PartnerAlias to match to asset packages. Case insensitive. No spaces or symbols. | Required for Offer | |
UniqueID | The internal ID for the feature or episode. 50-character limit. Case insensitive. Should be unique within your catalog. Only letters, numbers, and underscores; no spaces or symbols. | Required for Offer | |
Type | The type of transaction available: EST for purchase or VOD for rental. | EST and VOD | Required for Offer |
Quality | The quality or format of the transaction. | SD, HD, and UHD | Required for Offer |
PreorderDate | The pre-order date for a movie. This is the day customers can purchase the title, but it will not be consumable until the WindowStartDate. Valid date between 1/1/2000 to 12/31/2049 only. | YYYY-MM-DDThh:mm:ss | Optional for Movie Offer |
WindowStart | Date the content will be available to and consumable by customers. Valid date between 1/1/2000 to 12/31/2049 only. | YYYY-MM-DDThh:mm:ss | Required for Offer |
WindowEnd | Date the content will no longer be available to customers. Doesn't affect content that has already been purchased/rented by a customer. Valid date between 1/1/2000 to 12/31/2049 only. | YYYY-MM-DDThh:mm:ss | Optional for Offer |
If you prefer to not utilize the Simple Asset Manifest to deliver to the Prime Video Classic territories, you must follow the File Name Convention. Prime Video uses the hyphen ("-") as a delimiter between values within the file name of the provided asset. This naming convention must be followed exactly. Failure to do so will result in assets not matching to the correct title or processing correctly.
File Naming Convention: [PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
Example: Titan-ExplosionsMovie-Full-Mezz_HD-en-US.mpg
In the File Name Examples table below, descriptions are provided for each of the specific fields required in each asset file name. In the examples provided, brackets ("[" and "]") are used to delineate required components and must not be included in the file name. They are only included in these examples to increase legibility.
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
PartnerAlias: A Prime Video-defined alias used to identify the partner. You will be provided this alias during the onboarding process. This alias is generally an abbreviation of the full partner name. e.g., "Titan Studios" = "Titan." This alias is only used internally and isn't customer-facing.
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
UniqueID: A Partner-defined value (a.k.a. SKU or EIDR) that uniquely defines a title. Every title (Episode, Season, Series, Movie) requires a UniqueID. You may use your own internal tracking number, provided it meets the below requirements:
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
ContentType: Details whether the asset contains the full program material or trailer. The below entries are valid:
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
AssetType: Describes the type of asset being delivered. The below values are valid:
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory].xxx
LanguageCode: Describes the language contained on this particular file. This pairs with the Territory to form the Language-Locale section of the file name. See the Language and Locale Tags section for a complete list of allowed pairings. For example:
[PartnerAlias]-[UniqueID]-[ContentType]-[AssetType]-[LanguageCode]-[Territory]-[OtherInformation].xxx
OtherInformation: Any additional information that that needs to be communicated via the file name can be added after the locale. A "-" (hyphen) must be used to separate the [Territory] from these additional details. Examples of how this could be used are:
Check the relevant sections for supported extensions/file types for each kind of assetvideo, audio, captions, subtitles, images, and metadata.
The following table provides examples of acceptable file names. In this example, a partner with the PartnerAlias "Titan" is delivering a title with the [UniqueID] of "ExplosionsMovie":
File | Description | ContentType Value | AssetType Value | Locale | Example File Name |
---|---|---|---|---|---|
Mezzanine | SD mezzanine file for title. | Full | Mezz_SD | Japanese | Titan-ExplosionsMovie-Full-Mezz_SD-ja-JP.mpg |
Mezzanine | SD mezzanine file for title. | Full | Mezz_SD | German | Titan-ExplosionsMovie-Full-Mezz_SD-de-DE.mpg |
Mezzanine | HD mezzanine file for the title. | Full | Mezz_HD | British English | Titan-ExplosionsMovie-Full-Mezz_HD-en-GB.mpg |
Mezzanine | HD mezzanine file for the title. | Full | Mezz_HD | U.S. English | Titan-ExplosionsMovie-Full-Mezz_HD-en-US.mpg |
Mezzanine | SD mezzanine file for the trailer. | Trailer | Mezz_SD | Japanese | Titan-ExplosionsMovie-Trailer-Mezz_SD-ja-JP.mov |
Mezzanine | HD mezzanine file for the trailer. | Trailer | Mezz_HD | U.S. English | Titan-ExplosionsMovie-Trailer-Mezz_HD-en-US.mov |
Image | Main image for the title. | Full | Image | Japanese | Titan-ExplosionsMovie-Full-Image-ja-JP.jpg |
Image | Main image for the title. | Full | Image | German | Titan-ExplosionsMovie-Full-Image-de-DE.jpg |
Captions | A 23.98fps (23.976) Non-Drop Frame caption file for the title. | Full | Caption2398NDF | U.S. English | Titan-ExplosionsMovie-Full-Caption2398NDF-en-US.scc |
Captions | A 24fps caption file for the title. | Full | Caption24 | German | Titan-ExplosionsMovie-Full-Caption24-de-DE.scc |
Subtitle | A 25fps subtitle file for the title. | Full | Subtitle25 | British English | Titan-ExplosionsMovie-Full-Subtitle25-en-GB.scc |
Captions | A 29.97fps Drop Frame caption for the title. | Full | Caption2997DF | U.S. English | Titan-ExplosionsMovie-Full-Caption2997DF-en-US.scc |
Subtitle | A 29.97fps Non-Drop Frame subtitle for the title. | Full | Subtitle2997NDF | U.S. English | Titan-ExplosionsMovie-Full-Subtitle2997NDF-en-US.scc |
Mezzanine | HD mezzanine file for the title. | Full | Mezz_HD | British English | Titan-ExplosionsMovie-Full-Mezz_HD-en-GB-R1.mpg |
Please sign in to continue
Sign In