Content Launcher Certification for Catalog and Voice Customer Experience
Open Beta Documentation Amazon offers this technical
documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback
and iterates on the features. For the most current feature information, see the latest Release
Notes.
This page describes the certification test cases for all catalog integrated apps.
Requirements for launching content through the remote
Changing from unauthenticated to authenticated state
Use the Account Login API to notify Fire TV that the app is in a logged-in state.
Expected result:
- The app should send the login status
true, indicating entitlement after login. - The app tile is under "Watch Now" on the content detail page.
Changing from authenticated to unauthenticated state
Use the Account Login API to notify Fire TV that the app is in a logged-out state.
Expected result:
- The app should send login status
falseafter logout. - The content detail page lists app tile under "Subscribe."
Handling playback in an authenticated state
Make your content able to launch from the Fire TV Home screen once the user has logged in.
Expected result:
- The account detail page lists the app under "Watch Now" or "Watch Free" on the Fire TV Home screen.
- If the user clicks the app tile on the content details page, the app should launch the app and start content playback immediately. No user reauthenticate or navigate to the content detail page within the app is required.
Handling playback in unauthenticated state
The app should show a sign-in or sign-out page when launched from the Fire TV Home screen if the user logs out.
Expected result:
- The content detail page lists the app under "Subscribe" on the Fire TV Home screen.
- Clicking the Subscribe button should launch the app and display the sign-up or sign-in screen.
- The app should start playing the selected content without requiring further navigation once the user successfully signs in or subscribes.
Requirements for watch utterances
Implement watch or play utterances in the Content Launcher API.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Watch [title] | "Watch Breaking Bad" | The requested media plays. If there are multiple matches for the content, the user chooses from a prompt. |
| Watch by actor | "Watch Sean Connery" | Media with that actor plays using an algorithm that selects the best match for the user. |
| Watch by genre name | "Watch comedy" | Media from the requested genre plays, using an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch by franchise [title] | "Watch Star Trek" | Either the top recommended result for the requested franchise plays, or give the user a list of matching franchises. |
| Watch by media type | "Watch a movie" | Either media matching the non-title request plays using an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch [title] with season number | "Watch Breaking Bad season two" | Unless the episode finished, the last watched episode in the series plays. If that episode finished, the next unwatched episode plays. |
| Watch [title] with episode number | "Watch Breaking Bad episode five" | The system identifies the correct season by the user's last watched episode. Unless the episode finished, the last watched episode in the series plays. The next episode plays if the last-watched episode finished. |
| Watch [title] with season and episode number | "Watch Breaking Bad season two, episode five" | The content for the requested season and episode plays. |
| Watch by character name | "Watch James Bond" | Either media matching the character name plays through an algorithm that selects recommended media. Another option is to give the user a list of media results. |
| Watch by sports team | "Watch Seahawks" | Either media matching the sports team plays through an algorithm that selects recommended media. Another option is to give the user a list of media results. |
| Watch by sports type | "Watch soccer" | Either media matching the sports type plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch by sports league | "Watch N. B. A. league" | Either media matching the sports league plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch by sports event | "Watch soccer game" | Either media matching the sports event plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
Requirements for search utterances (in-app search)
Support the following search/find utterances by implementing the Content Launcher API.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Search for [title] | "Search for Breaking Bad" | Content Launcher presents a list of matches for the title. |
| Search by actor | "Search for Sean Connery" | Content Launcher presents a list of matches featuring the actor. |
| Search by genre name | "Search for comedy" | Content Launcher presents a list of matching results for media from the requested genre. An algorithm personalizes the list to select recommended media. |
| Search [title] with episode number | "Search for Breaking Bad episode five" | A list of available episodes in the season the user recently watched appears. For example, if the user is currently on Season 2, a list of episodes from Season 2 appears. |
| Search [title] with season and episode number | "Search for Breaking Bad, season two, episode five" | A list of available episodes for the season the user requested appears, including the episode the user asked for. |
| Search [title] with season number | "Search Breaking Bad, season two" | Content Launcher presents a list of all episodes for the matching season. |
| Search by franchise [title] | "Watch Star Trek" | Content Launcher presents a list of matching results for the franchise. |
| Search by media type | "Search for a movie" | Content Launcher presents a list of matches for the desired media type. |
| Search for by character name | "Search for James Bond" | Content Launcher presents a list of matching results for media featuring the character's name. |
| Search by director name | "Search for Quentin Tarantino" | Content Launcher presents a list of matching results for media produced by that director. |
| Search by production company | "Search for Disney" | Content Launcher presents a list of matching results for media from that production company. |
| Search for by sports team | "Search Seahawks" | Content Launcher presents a list of matching results for that sports team. |
| Search for by sports type | "Search for soccer" | Content Launcher presents a list of matching results for that type of sport. Ideally, it's based on recommendations for that user. |
| Search for by sports league | "Search for N. B. A. league" | Content Launcher presents a list of matching results for that sports league. Ideally the list is based on recommendations for that user. |
| Search for by sports event | Search for soccer game" | Content Launcher presents a list of matching results for that sports event. Ideally the list is based on recommendations for that user. |
Requirements for transport control utterances
Alexa supports the following Transport Control utterances.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Pause | "Pause" | The media pauses, similar to if you pressed the Pause button on your web player or remote control. |
| Play | "Play" | The media plays, similar to if you pressed the Play button on your web player or remote control. |
| Stop | "Stop" | The media stops, similar to if you pressed the Stop button on your web player or remote control. |
| Resume | "Resume" | The media resumes play, similar to if you pressed the Play button on your web player or remote control. |
| Start over | "Start over" | The media starts over, adjusting the seek position back to the beginning of the media. |
| Fast Forward | "Fast Forward" | The media fast-forwards 10 seconds. |
| Rewind | "Rewind" | The media rewinds 10 seconds. |
| Previous | "Previous" | The previous episode plays. If this isn't possible, Content Launcher takes the user to what's earlier in the current playlist. |
| Next | "Next" | The next episode plays. If this isn't possible, Content Launcher takes the user to what's next in the current playlist. |
| Fast Forward [duration] | "Fast Forward thirty seconds" | The media fast-forwards for the requested duration. |
| Rewind [duration] | "Rewind forty seconds" | The media rewinds for the requested duration. |
Note: The W3C Media Player API does not support the Next and Previous commands. Implement Next and Previous with the Vega Media Controls API.
Last updated: Feb 17, 2026
