Add Rich Media to the Skill Detail Page

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

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.

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.

Use rich media assets

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.

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

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.

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

Sign in to the Amazon Alexa developer console.
From the skill list, locate the development version of your skill under STATUS, and then, in the dropdown under ACTIONS, select Distribute.
In the top-left menu, click Skill Preview > English(US), or choose the language that represents the primary locale of your skill.
Find the Media Details section.
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.
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.
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.
Repeat the previous steps up to four times, for a total of five images.
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

Sign in to the Amazon Alexa developer console.
From the skill list, locate the development version of your skill under STATUS, and then, in the dropdown under ACTIONS, select Distribute.
In the top-left menu, click Skill Preview > English(US), or choose the language that represents the primary locale of your skill.
Find the Media Details section.
In the upper-right corner of the asset you want to replace, click Edit.
Select the replacement asset from your computer, and then click Open.
If you want to delete the asset, click Delete, and then drag the new asset into the Images or Videos 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 media file certification

During skill certification, Amazon verifies that your media files are in the correct format and meet Amazon content standards. The certification team also validates that the images and video comply with Amazon guidelines. To pass certification, make sure that the media assets are appropriate for all ages and don't include any links or URLs. For more details, see Policy Requirements.

Was this page helpful?

Provide feedback

Last updated: Jun 28, 2024