Skip to content

Add closed captions and audio descriptions guidance for trailers #5460

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 6, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions hub/apps/publish/publish-your-app/msix/screenshots-and-images.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,15 +116,20 @@ Follow these recommendations to make your trailers effective:
- Use a different thumbnail for each trailer so that customers know they are unique.
- Because some Store layouts may slightly crop the top and bottom of your trailer, make sure key info appears in the center of the screen.
- Frame rate and resolution should match the source material. For example, content shot at 720p60 should be encoded and uploaded at 720p60.
- To make trailers more accessible for users with disabilities, you can upload closed captions and audio descriptions:
- Closed captions provide text alternatives for audio for individuals who are deaf or hard of hearing.
- Audio descriptions help provide audio alternatives for visual elements for individuals who are blind or have low vision.

You must also follow the requirements listed below.

**To add trailers to your listing:**

1. Upload your trailer **video file** in the indicated box. A drop-down box is also shown in case you want to reuse a trailer you have already uploaded (perhaps for a Store listing in a different language).
1. Click on **Upload** and upload your trailer **video file** in the indicated section. A drop-down box is also shown in case you want to reuse a trailer you have already uploaded (perhaps for a Store listing in a different language).
2. After you have uploaded the trailer, you'll need to upload a **thumbnail image** to go along with it. This must be a .png file that is 1920 x 1080 pixels, and is typically a still image taken from the trailer.
3. Click the pencil icon to add a **title** for your trailer (255 characters or fewer).
4. If you want to add more trailers to the listing, click **Add trailer** and repeat the steps listed above.
4. To add a closed caption file, click the "Upload" button in the closed captions section and select a Web VTT (.vtt) file. The file size must be less than 50 MB.
5. To add an audio description file, click the "Upload" button in the audio descriptions section and select an MP3 (.mp3) file. The file size must be less than 500 MB.
6. If you want to add more trailers to the listing, close the panel, click **Upload** and repeat the steps listed above.

> [!TIP]
> If you have created Store listings in multiple languages, you can select **Choose from existing trailers** to reuse the trailers you've already uploaded. You don't have to upload them individually for each language.
Expand All @@ -140,6 +145,8 @@ When providing your trailers, be sure to follow these requirements:
- The thumbnail must be a PNG file with a resolution of 1920 x 1080 pixels.
- The title can’t exceed 255 characters.
- Do not include age ratings in your trailers.
- The closed caption file must be in Web VTT (.vtt) format and the file size must be less than 50 MB
- The audio description file must be in MP3 (.mp3) format and the file size must be less than 500 MB

> [!WARNING]
> The exception to the requirement to include age ratings in your trailers applies **only** to trailers in the **Microsoft Store** that are shown **on the product page**. Any trailer posted outside of Partner Center, that is not intended for display exclusively on the Microsoft Store's product page **must** display embedded rating information, where required, in accordance with the appropriate rating authority’s guidelines.
Expand Down