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

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.

Placement

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

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

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.

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 format

PNG

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

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 format

PNG

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.

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

To upload a video

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

To upload a featured image for your video

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

To upload other images

  1. In the Detail Page Images section, in the space marked Images, drag and drop an image file into place.
  2. Alternatively, to upload an image file from your computer, click anywhere inside the Images space, select an image, and click Open.
  3. Repeat step 1 or step 2 up to four times, for a total of five images.
  4. 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.

  1. In the upper-right corner of the asset you want to replace, click Edit.
  2. Select the replacement asset from your computer, and click Open.
  3. 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.
  4. 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 details, see Policy Testing.