Note: This documentation applies to the use of bulk file delivery only.
To review artwork asset requirements, see Artwork requirements. To successfully deliver artwork assets to Prime Video, artwork files (.jpg, .png) must be uploaded to Aspera or S3, and references must be included in either Media Entertainment Core (MEC) or Media Manifest Core (MMC).
Purpose references
Purpose references are used in the MEC and MMC to identify the type of images being delivered. Image purpose is supported differently according to title level type (such as episode, movie, or season). Refer to the following table for purpose usage guidance.
Cover art |
16:9 |
Movies and Seasons |
cover |
Box art |
4:3 |
Seasons |
boxart |
Box art |
3:4 |
Movies |
boxart |
Poster art |
2:3 |
Movies and Seasons |
poster |
Hero (background) art |
16:9 |
Movies and Seasons |
hero |
Title art |
Flexible |
Movies and Seasons |
title |
Episodic art |
16:9 |
Episodes |
cover |
Trailer & bonus art |
16:9 |
Trailers & Bonus |
cover |
Global (region-less) artwork requirement
This is the standard delivery requirement. Global artwork delivery includes language-LOCALE, but does not include Region. With global artwork, customers can be served a customized experience driven by their UI language preference. For example, a customer living in Canada with Spanish set as their UI language would see Spanish artwork, because it was delivered with Spanish in language-LOCALE and without a Region value.
Region-specific artwork exception
This is a delivery exception that is only intended for specific use cases. Region-specific artwork delivery includes both language-LOCALE and Region. Although region-specific delivery is supported, we also require at least one Global artwork delivery per image type (box art, cover art, and poster art) for Seasons and Movies. Accepted use cases are:
- Compliance versions, such as omitting cigarettes in India.
- Region-specific originals branding (when allowed).
All other use cases, including but not limited to region-specific extraneous text, calls-to-action, or marketing callouts, are not accepted.
Language-LOCALE and Region behavior
- Language-LOCALE: This field is required for all artwork references. It identifies the language of the artwork being delivered. For example, artwork delivered with pt-BR signifies that the artwork has been localized in the Brazilian Portuguese language.
- Region: This field is optional and identifies a specific territory in which the region-specific artwork will be displayed instead of the global artwork. If the Region field is provided, it will block the global artwork in that region. If no Region field is provided, the artwork is eligible to be leveraged on the storefront globally.
Right-to-left language requirements
Because Arabic and Hebrew are read right-to-left, customers with their UI language set to Arabic or Hebrew will see the overlay metadata/text on the right side of the display page instead of the left. If you are delivering right-to-left (RTL) hero artwork for Hebrew or Arabic, please use he-IL and ar-AE as the standard code for all Arabic-language deliveries, because the ar-001 language code has been deprecated. While ar-AE is the preferred code for Arabic, the alternative language-LOCALE codes shown in the following table are also accepted. All other language codes will be considered left-to-right (LTR).
Hebrew |
he-IL |
Arabic |
ar-DZ |
ar-EG |
|
ar-MA |
|
ar-AE (preferred) |
|
ar-KW |
|
ar-SY |
|
ar-LB |
|
ar-TN |
|
ar-LY |
|
ar-YE |
|
ar-QA |
|
ar-IQ |
|
ar-SA |
|
ar-BH |
|
ar-JO |
|
ar-OM |
|
ar-TD |
|
ar-DJ |
|
ar-KZ |
|
ar-MR |
|
ar-PS |
|
ar-SS |
|
ar-ER |
|
ar-SO |
|
ar-IL |
|
ar-EH |
|
ar-SD |
|
ar-KM |
For more information about RTL and LTR artwork requirements, see the Guidelines section in Artwork specifications.
MMC references
MMC is the preferred method to submit artwork references. It’s simpler to reference localized artwork in MMC, and unlike MEC, it has no reliance on title metadata. MMC can be used to ingest original language and localized artwork files if you provide purpose, language, and region values.
The following table lists artwork-relevant fields in the MMC asset manifest.
Field |
Definition and notes |
Accepted values |
Usage |
Inventory |
Identifies all individual assets being delivered as part of the package (such as mezzanine files, timed text, audio, and so on) along with asset-specific metadata. |
Required |
|
Image |
manifest:Image |
||
@ImageID |
ID used to reference the image throughout the MMC. |
Required for image delivery |
|
Purpose |
Identifies the type of artwork being delivered and determines placement. |
boxart, cover, hero, poster, title |
Required |
Language |
Identifies the language of the artwork being delivered. |
Required |
|
Width |
Width, in pixels, of the image being delivered. |
String (for example, 1920) |
Optional |
Height |
Height, in pixels, of the image being delivered. |
String (for example, 1080) |
Optional |
AssetIntent |
Identifies artwork that is specific to a region and should not be displayed elsewhere, such as compliance versions. If not included, artwork will be considered eligible to be displayed in all regions. |
Optional |
|
Type |
Identifies artwork that is specific to a region and shouldn’t be displayed elsewhere, like compliance versions. If not included, artwork will be considered eligible to be displayed in all regions. |
Region |
Optional |
Subtype |
Identifies artwork that is specific to a region and shouldn’t be displayed elsewhere, like compliance versions. If not included, artwork will be considered eligible to be displayed in all regions. |
Country codes |
|
PictureGroups |
A list of Picture Groups. Selection of images associated with a title or series. |
Required |
|
PictureGroup |
A single Picture Group. Selection of images associated with a title or series. |
||
@PictureGroupID |
The picture group ID that refers to the parent (movie, episode or series) Content ID. md:picturegroupid:[scheme]:[SSID]. |
Required for image delivery |
|
Picture |
Describes an individual picture, including how it relates to other pictures when sequenced within a Gallery. |
Required |
|
PictureID |
Required by the XSD. Not used by Prime Video. |
Value is ignored; can be blank |
Not used, but required |
ImageID |
ID used to reference the image throughout the MMC. |
Required for image delivery |
|
Experiences |
The Experience section of the MMC groups together Presentations and/or Playable Sequences along with Picture Groups to define the customer experience. |
Required |
|
Experience |
The Experience element that defines which title and galleries apply. |
||
@ExperienceID |
ID used to reference the Experience throughout the MMC. |
Required |
|
ContentID |
Not used by Prime Video. Matching is based on UniqueID. |
Not used |
|
PictureGroupID |
References to PictureGroups. |
||
ALIDExperienceMaps |
Relates ALIDs to the Experiences associated with that content. |
Required |
|
ALIDExperienceMap |
Experiences can be localized, so a single ALID can only map to one Experience. |
Required |
|
ALID |
A Logical Asset ID (ALID) used to identify a set of content (such as a Logical Asset) associated with avails in an EMA Avails submission. |
Required |
|
ExperienceID |
Required |
||
Presentations |
One Presentation instance is required for each set of conformed tracks. Not required for partial MMC delivery only, including artwork references. |
Required by AudioVisual |
For a full list of all MMC-supported fields, see MMC asset manifest.
MMC partial image delivery
Artwork files can be referenced independently of other assets, or as part of the complete asset package MMC.
- Partial MMCs should only contain Inventory objects for assets included in the updated package. You don’t need to declare Inventory for assets that were previously delivered to Prime Video.
- Only declare Presentations when they contain assets that are present in the MMC Inventory and in the package.
When you are only referencing artwork assets, you should exclude Presentations from the MMC.
- The ALID is the only ID that must match between an initial package and an updated package that contains new assets.
The following is an example of a partial MMC for a movie title that references artwork assets only:
<?xml version="1.0" encoding="UTF-8"?> |
<manifest:MediaManifest xmlns:manifest="http://www.movielabs.com/schema/manifest/v1.5/manifest” xmlns:md="http://www.movielabs.com/schema/md/v2.4/md” xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xsi:schemaLocation="http://www.movielabs.com/schema/manifest/v1.5/manifest manifest-v1.5.xsd"> |
<manifest:Compatibility> |
<manifest:SpecVersion>1.5</manifest:SpecVersion> |
<manifest:Profile>MMC-1</manifest:Profile> |
</manifest:Compatibility> |
<manifest:Inventory> |
<!-- Regionless English Movie Cover Art to be displayed Globally --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:cover.art.en"> |
<md:Purpose>cover</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>cover_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Regionless English Movie Box Art to be displayed Globally --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>boxart</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Regionless English Movie Hero Art to be displayed Globally --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:hero.art.en"> |
<md:Purpose>hero</md:Purpose> |
<md:Width>1920</md:Width> |
<md:Height>1080</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>hero_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- Regionless English Movie Title Art to be displayed Globally --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:title.art.en"> |
<md:Purpose>title</md:Purpose> |
<md:Width>3450</md:Width> |
<md:Height>560</md:Height> |
<md:Encoding>png</md:Encoding> |
<md:Language>en-US</md:Language> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>title_art.png</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
<!-- English Movie Box Art with region, to be displayed in US and CA only --> |
<manifest:Image ImageID="md:imageid:org:partneralias:title_SKU:box.art.en"> |
<md:Purpose>boxart</md:Purpose> |
<md:Width>1200</md:Width> |
<md:Height>1600</md:Height> |
<md:Encoding>jpg</md:Encoding> |
<md:Language>en-US</md:Language> |
<md:AssetIntent> |
<md:Type>Region</md:Type> |
<md:SubType>US</md:SubType> |
</md:AssetIntent> |
<md:AssetIntent> |
<md:Type>Region</md:Type> |
<md:SubType>CA</md:SubType> |
</md:AssetIntent> |
<manifest:ContainerReference> |
<manifest:ContainerLocation>box_art.jpg</manifest:ContainerLocation> |
</manifest:ContainerReference> |
</manifest:Image> |
</manifest:Inventory> |
<manifest:PictureGroups> |
<manifest:PictureGroup PictureGroupID="md:picturegroup:org:partneralias:title_SKU:picturegroup"> |
<manifest:Picture> |
<!-- PictureID is required by the XSD, but is not needed by Amazon --> |
<manifest:PictureID></manifest:PictureID> |
<manifest:ImageID>md:imageid:org:partneralias:title_SKU:cover.art.en</manifest:ImageID> |
<manifest:ImageID>md:imageid:org:partneralias:title_SKU:box.art.en</manifest:ImageID> |
<manifest:ImageID>md:imageid:org:partneralias:title_SKU:hero.art.en</manifest:ImageID> |
<manifest:ImageID>md:imageid:org:partneralias:title_SKU:title.art.en</manifest:ImageID> |
<manifest:ImageID>md:imageid:org:partneralias:title_SKU:box.art.en.CA.US</manifest:ImageID> |
</manifest:Picture> |
</manifest:PictureGroup> |
</manifest:PictureGroups> |
<!-- Root Experience --> |
<manifest:Experiences> |
<manifest:Experience ExperienceID="md:picturegroup:org:partneralias:title_SKU:picturegroup:experience” version="1.0"> |
<manifest:ContentID>md:cid:org:partneralias:title_SKU</manifest:ContentID> |
<manifest:PictureGroupID>md:picturegroup:org:partneralias:title_SKU:picturegroup</manifest:PictureGroupID> |
</manifest:Experience> |
</manifest:Experiences> |
<manifest:ALIDExperienceMaps> |
<manifest:ALIDExperienceMap> |
<manifest:ALID>md:ALID:org:partneralias:title_SKU</manifest:ALID> |
<manifest:ExperienceID>md:picturegroup:org:partneralias:title_SKU:picturegroup:experience</manifest:ExperienceID> |
</manifest:ALIDExperienceMap> |
</manifest:ALIDExperienceMaps> |
</manifest:MediaManifest> |
MEC references
While MEC is primarily used to deliver title metadata (synopsis, actors, ratings, and so on), it can also be used to communicate artwork references.
When you leverage MEC for artwork delivery, an ArtReference field within the LocalizedInfo section must be present. This allows you to reference multiple pieces of artwork for a single title and to communicate metadata elements about the artwork, like resolution, purpose, and language.
Language, filename, and purpose must be included within each LocalizedInfo section. The language-locale for your artwork should align to the localized title metadata provided in a given LocalizedInfo section.
When you submit a full MEC that contains title metadata and artwork references, the artwork references will be tagged with the language entered for the corresponding LocalizedInfo block. Make sure that the artwork being delivered matches the language submitted. If you need to submit artwork in a language that doesn’t match the main metadata language provided, you must enter a second LocalizedInfo block and must include the required metadata fields (TitleDisplayUnlimited and Summary400) with the corresponding ArtReference artwork references. For an example of this use case, see the .xml sample files in the MMC and MEC samples section later in this topic.
The following table lists artwork-relevant fields in MEC title metadata.
LocalizedInfo |
Includes elements that may be localized. |
Required |
|
@Language |
Identifies the language of the artwork being delivered. |
Required |
|
@Region |
Identifies artwork that is specific to a region and should not be displayed elsewhere, like compliance versions. If not included, artwork will be considered eligible to be displayed in all regions. |
Country codes |
Optional |
ArtReference |
At least one ArtReference per title is required when referencing artwork. |
Required |
|
@Resolution |
Resolution of the artwork being delivered. |
String in the form colXrow |
Optional |
@Purpose |
Identifies the type of artwork being delivered and determines placement. |
boxart, cover, hero, poster, title |
Required |
MEC partial image delivery
MEC can be leveraged to deliver artwork independent of title metadata, with an added md:Profile that relaxes parsing validations.
The following is an example of a partial MEC for a movie title that references artwork assets only.
<?xml version="1.0" encoding="UTF-8"?> |
<mdmec:CoreMetadata xmlns:mdmec="http://www.movielabs.com/schema/mdmec/v2.9" xmlns:md="http://www.movielabs.com/schema/md/v2.9/md” xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” xsi:schemaLocation="http://www.movielabs.com/schema/mdmec/v2.9 ../mdmec-v2.9.xsd"> |
<mdmec:Compatibility> |
<md:SpecVersion>2.9</md:SpecVersion> |
<!-- Profile CM-IMAGE-1 indicates that this file conforms to image-only profile. Amazon will not parse any title metadata from the file when this profile is provided --> |
<md:Profile>CM-IMAGE-1</md:Profile> |
</mdmec:Compatibility> |
<mdmec:Basic ContentID="md:cid:org:partneralias:titlesku"> |
<!-- English artwork with region, to be displayed in US only--> |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_US.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_US.jpg</md:ArtReference> |
<md:Region> |
<md:country>US</md:country> |
</md:Region> |
</md:LocalizedInfo> |
<!-- Regionless English artwork intended to be used Globally--> |
<md:LocalizedInfo language="en-US"> |
<md:ArtReference purpose="boxart">box_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="hero">hero_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_en_global.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_en_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<!-- Regionless Brazilian Portuguese artwork intended to be used Globally--> |
<md:LocalizedInfo language="pt-BR"> |
<md:ArtReference purpose="boxart">box_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="cover">cover_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="poster">poster_art_pt_br.jpg</md:ArtReference> |
<md:ArtReference purpose="title">title_art_pt_br_global.png</md:ArtReference> |
</md:LocalizedInfo> |
<!-- MEC spec requires ReleaseYear and WorkType. When delivering with CM-IMAGE-1, Amazon will ignore these values. --> |
<md:ReleaseYear>2018</md:ReleaseYear> |
<md:WorkType>movie</md:WorkType> |
<md:AltIdentifier> |
<md:Namespace>ORG</md:Namespace> |
<md:Identifier>titlesku</md:Identifier> |
</md:AltIdentifier> |
<md:AssociatedOrg organizationID="partneralias” role="licensor” /> |
</mdmec:Basic> |
Classic Artwork deliveries via MMC
Prime Video can now support delivery and/or replacement of artwork for titles that were previously delivered to Classic Marketplaces (US, DE, JP, and GB) by leveraging the current MMC spec as explained in MMC references above. Please note that MEC artwork references are not supported for this specific use case (Classic Titles).
Supported artwork types (all)
Purpose in the MMC |
Type |
Movies |
Series level |
Season level |
Episode level |
Trailer and Bonus |
boxart |
Box art |
X |
X |
|||
cover |
Cover art |
X |
X |
|||
poster |
Poster art |
X |
X |
|||
hero |
Hero art |
X |
X |
|||
title |
Title art |
X |
X |
|||
cover |
Episodic art |
X |
||||
cover |
Trailer and Bonus art |
X |
Delivery specs
Please make sure to use the same partner alias and SKU used when the Classic title was initially created. Specs are identical to MMC Global specs; all artwork types, language locales, and regions are supported.
Classic artwork delivery FAQs
MEC schema errors
Error message |
Cause |
More than one instance of LocalizedInfo is provided for the same language. |
There are duplicate LocalizedInfo blocks (by type and region). |
If providing Region values, one LocalizedInfo element for that language must apply for all territories (no Region override). |
There is no region-less block. |
