Alexa.ChannelController interface sends ChangeChannel directives to indicate that the channel should be changed. These directives are sent when users specify the channel name, call sign, or channel number.
Utterances for ChannelController Directives
Alexa sends aChangeChannel directive through the ChannelController interface to your Lambda when users say the following utterances.
ChangeChannel Directive Example
The following is an exampleChangeChannel directive:
- App-only Integrations
- Cloudside Integrations
payload contains the following:Payload Definitions
Experience Types
Use theexperience object to optimize the display of search results based on the device used to perform the search. For example, if a customers searches from a Fire TV remote, the experience object shows a large number of search results that the customer can browse through with a remote. However, if the search request is from an Echo paired to Fire TV, the experience object limits the number of results shown, and how they are displayed, allowing the customer to see results without using the remote.
The experience object consists of a mode object, which determines how to display the search results. The mode object takes two values: VOICE_OPTIMIZED and DEFAULT.
-
VOICE_OPTIMIZED: The optimized display of search results for voice-only devices. Provides a list of results that customers can navigate via voice, without the need for a remote. -
DEFAULT: The default displays of all search results list format, regardless of the device used for the search.
DEFAULT instead of failing if you receive an unknown value in mode.
Handling ChangeChannel Directives
TheChangeChannel directive allows customers to tune to a specific channel using voice commands. When users say “Alexa, tune to CNN,” you receive a ChangeChannel directive in your Lambda. You then need to change the live TV stream to show the user the correct channel.
To help you understand which directive corresponds with which channel, we have provided a list of possible for each channel in Channels List.
If you’d like to support additional channels not included in this list, reach out to your Amazon contact, and he or she will coordinate with the right people to get you the information you need on how to handle it.
Alternatively, try asking your Alexa-enabled device to change the channel to whichever channel you like, and then observe the directive received in your Lambda log to check the callsign for yourself. However, it’s still best if you flag those channels to your Amazon contact so we can know to prioritize that channel in our voice models. The channel callsign will be available within the callSign field within the channel change directive’s payload.
You will not receive information about local channels in the directives — just top level names and callsigns, such as “ABC.” It is up to you to perform any localization for your users.
Response Example
You must send anResponse event if a request to change channels was successful. The response should include a context object that reports the channel after the request completes.

