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

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

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 |
Asset content type is invalid. |
Asset with identifier |
Each asset must be less than 100 MB. |
Asset with identifier |
Asset content type ( |
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 |
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.
Related topics
- Add Rich Media to Your Skill Detail Page
- Define Skill Store Details and Availability
- Create and Manage Skills in the Developer Console
Last updated: Apr 26, 2023