Add Rich Media to the Skill Detail Page


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 can improve customer engagement. Rich media includes images, video, and the featured (still) image customers see before your video plays. You add rich media when you define skill details on the Distribute tab in the Alexa developer console. For more details, see Define Skill Store Details for Publication.

You can also use the Alexa Skills Kit (ASK) Command Line Interface (CLI) to upload your rich media assets. For more details, see Add Rich Media to Your Skill Detail Page.

Use rich media assets

Skill detail page on a mobile device

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.

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.

Prerequisities

Before you begin, upload a skill icon on the Skill Preview page.

Prepare your media files and make sure your rich media assets meet the following requirements.

Image specifications

The following table shows the specifications for images.

Specification 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.

Specification 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.

The following table shows specifications for the featured images.

Specification 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, you upload your media assets to the Skill Preview page on the developer console as shown in the figure. The assets appear on your skill detail page in the order in which you upload them.

To upload your video, featured image, and other images

  1. Sign in to the Amazon Alexa developer console.
  2. From the skill list, locate the development version of your skill under STATUS, and then, in the dropdown under ACTIONS, select Distribute.
  3. In the top-left menu, click Skill Preview > English(US), or choose the language that represents the primary locale of your skill.
  4. Find the Media Details section.
  5. To upload a video, under Detail Page Video, in the space marked Video, drag a video file into place.
    Or, to select a video file from your computer, click anywhere inside the Video box, navigate to the appropriate folder, select the video file, and then click Open.
  6. To upload a featured image for your video, in the space marked Video thumbnail, drag an image file into place.
    Or, to select a featured image file from your computer, click anywhere inside the Video thumbnail box, select the image, and then click Open.
  7. To upload other images, under Detail Page Images, in the space marked Images, drag an image file into place.
    Or, to select an image file from your computer, click anywhere inside the Images box, select an image, and then click Open.
  8. Repeat the previous steps up to four times, for a total of five images.
  9. Click Save and continue.

Replace assets

You can replace or update an image or video that you previously uploaded.

To replace your video, featured image, and other images

  1. Sign in to the Amazon Alexa developer console.
  2. From the skill list, locate the development version of your skill under STATUS, and then, in the dropdown under ACTIONS, select Distribute.
  3. In the top-left menu, click Skill Preview > English(US), or choose the language that represents the primary locale of your skill.
  4. Find the Media Details section.
  5. In the upper-right corner of the asset you want to replace, click Edit.
  6. Select the replacement asset from your computer, and then click Open.
  7. If you want to delete the asset, click Delete, and then drag the new asset into the Images or Videos space.
  8. 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 make sure that they're in the correct format and meet Amazon content standards. The Alexa team validates the content of the files to make sure they comply with Amazon guidelines. Rich media assets on skill detail pages must be appropriate for all ages. For more details, see Policy Requirements.


Was this page helpful?

Last updated: Jan 26, 2024