Add Rich Media to the Skill Detail Page in the Developer Console

Note: Sign in to the developer console to build or publish your skill.

Important: This topic explains how to use the Amazon Alexa developer console to add rich media to your skill detail page. To use the Alexa Skills Kit command line interface (ASK CLI) to upload your rich media assets, see Add Rich Media to Your Skill Detail Page.

You can increase customers' interest in your skill and expand your customer base by adding rich media, such as video and images, to your Alexa skill detail page.

Use rich media assets

Your skill detail page educates customers about the value of your skill and shows them how the skill works. The use of rich media assets on your skill detail page increases customer engagement with Alexa. Rich media includes images, video, and the featured (still) image customers see before your video plays.

The figures in this section show how rich media looks on finished skill detail pages. The first figure shows a skill detail page viewed on a mobile device. The second shows a skill detail page displayed in the Alexa Skills Store.

Placement

Rich media assets are displayed across Amazon Alexa skill detail pages in the following locations.

Skill detail page in the Alexa Skills Store on the Amazon retail website
Alexa app
Other Amazon properties

Limits

You can upload one video and up to five images, not including the featured image for your video. The use of rich media is optional—you're not required to add images or video to your skill for distribution. If you choose not to use rich media, your skill’s logo continues to be the primary image that represents your skill.

Locales

Skill detail page in the Alexa Skills Store

You can designate specific media assets for each locale in which your skill is distributed. When you use locale-specific assets, videos are spoken in the language the customer expects, and written captions, signs, and other language appears in the customer's language. The asset limits for each locale are the same as for the primary locale—that is, one video and up to five images. Your locale-specific assets must also pass certification.

Prepare your assets

Before you begin, you must access the developer console, add your skill logo and metadata, and make sure your rich media assets meet the required specifications.

Access the developer console

Before you upload your rich media assets, you need an Amazon developer account to access the Amazon Alexa developer console. You can use an existing Amazon account to sign in, or you can create a new account. The account is free.

Important: To represent your skill, Amazon reserves the right to use the images and videos you submit on all Amazon properties. In addition, you must provide marketer access to your skill so that Amazon can edit your media as necessary. For details, see Manage Your Amazon Developer Account and Permissions.

Supply a skill logo and metadata

If you haven't already done so, upload a skill logo and supply the specified metadata for your skill, including your skill name, brief and detailed descriptions, example launch phrases, skill category, keywords, privacy policy URL, and terms of use URL. For instructions, see Tutorial: Build Your First Alexa Skill in the Developer Console.

Meet rich media asset requirements

To ensure a consistent customer experience, format your rich media assets according to the following specifications.

Image specifications

The following table shows the specifications for images on your skill detail page.

Spec	Value
Supported file formats	PNG, JPG
Resolution	1200 x 800 px
Aspect ratio	16:10
Maximum file size	20 MB

Video specifications

The following table shows the specifications for videos on your skill detail page.

Spec	Value
Supported file formats	QuickTime, H.264 MPEG-4 (MP4, MOV)
Resolution	1280 x 720 px
Aspect ratio	16:9
Maximum file size	100 MB
Duration	15-60 sec
Minimum bit rate	1200 kbps

Featured image specifications

For your videos, you can supply a thumbnail image to serve as the featured frame. The featured frame is the still preview that customers see before your video plays. If you decide to use a frame from the video as your featured image, you must manually upload that image to the Skill Preview page (see the upload instructions in this document). The following table shows specs for the featured image.

Spec	Value
Supported file formats	PNG, JPG
Resolution	1280 x 720 px
Aspect ratio	16:9
Maximum file size	20 MB

Upload rich media assets

Rich media assets on the Skill Preview page in the Alexa developer console.

To add rich media to your skill detail page with the developer console, you must upload your media assets to the Skill Preview page in the console, as shown in the figure. The assets appear on your skill detail page in the order in which you upload them.

Add new assets

Use the instructions that follow to upload your video, featured image, and other images.

Sign in to the Amazon Alexa developer console.
Open the Distribution tab.
Click Skill Preview > English (US), or choose the skill preview that represents your skill's locale.
Find the Media Details section.

To upload a video

In the Detail Page Video section, in the space marked Video, drag and drop a video file into place.
Alternatively, to upload a video file from your computer, click anywhere inside the Video space, select the video file, and click Open.
Click Save and continue.

To upload a featured image for your video

To designate a featured image for your video, in the space marked Video thumbnail, drag and drop an image file into place.
Alternatively, to upload the featured image file from your computer, click anywhere inside the Video thumbnail space, select the image, and click Open.
Click Save and continue.

To upload other images

In the Detail Page Images section, in the space marked Images, drag and drop an image file into place.
Alternatively, to upload an image file from your computer, click anywhere inside the Images space, select an image, and click Open.
Repeat step 1 or step 2 up to four times, for a total of five images.
Click Save and continue.

Replace assets

To replace or update an image, sign in to the developer console and open Distribution > Skill Preview > Media Details, as in the preceding section.

In the upper-right corner of the asset you want to replace, click Edit.
Select the replacement asset from your computer, and click Open.
Alternatively, in the upper-right corner of the asset you want to replace, click Delete, and then drag and drop the new asset into the Images space.
Click Save and continue.

Troubleshoot error messages

If you upload an image or video that's formatted incorrectly, one or more of the following error messages appears when you click Save and continue. For format specifications, see Image specifications and Video specifications.

Example error message	Description
Resource with identifier `giphy.gif` has invalid content type. Received content type: `image/gif`. Allowed content types: [`video/mp4`, `video/quicktime`, `image/png`].	Asset content type is invalid.
Asset with identifier `giphy.gif` has invalid file size. Maximum size allowed is 104857600 bytes.	Each asset must be less than 100 MB.
Asset with identifier `giphy.gif` has an invalid format.	Asset content type (`PNG`, `MP4`, `MOV`) is valid, but an error occurred during extraction of asset attributes (width, height, or duration, for example).
Encountered an error during the upload process. Please try again.	An exception occurred while saving assets to Lambda temporary storage (S3), or an exception occurred while reading files or creating a `ZIP` file from the uploaded assets.

Pass file certification

When your upload is complete, your rich media assets must be certified to ensure that they're formatted correctly and meet Amazon content standards. The Alexa team validates the content of the file to ensure compliance with Amazon guidelines. Rich media assets on skill detail pages must be appropriate for all ages. For more details, see Policy Requirements.

Last updated: Apr 26, 2023