Badges You Can Implement
The following table shows the types of display badges you can implement.| Badge Type | Description |
|---|---|
| Recording | This badge is displayed when the user is actively recording the content. This badge takes precedence over all other badges. |
| Live | This badge is displayed when the content is currently airing in real time (for example, shows such as the Oscars, Emmys, and sports games). |
| On Now | This badge is displayed when the content is airing on a channel at a given time, and is not considered Live. |
Network Logo
In addition to badges, you should also show the Network logo or the Network call sign, which indicates where this piece of content is airing. For example, suppose a user says, “Show me comedy TV shows on [provider].” In such cases, [provider] can show content from multiple networks, such as ABC, HBO, CBS, and others. When you return such results on a multimodal device, you should also show a network logo on the bottom of the box art to indicate the origin of the content. If the network logo is not available, you should show the network call sign, such as ABC, HBO, etc.Content Freshness
You should also indicate whether the content is “new” with the search results metadata. This information comes from content providers and is displayed to indicate that this content is airing for the first time. For example, if you search for episodes of “The Big Bang Theory,” and episodes 1-5 were aired already and now episode 6 is available to view, content providers should let you know so that you can display “NEW” along with other metadata for that episode. You can specify badging in your skill through theGetDisplayableItemsMetadataResponse and GetPlayableItemsMetadataResponse responses from your Lambda.
Badging APIs
To support badging, you should use the following structures within theGetDisplayableItemsMetadataResponse response payload:
recording: Used to indicate if content is currently being recorded.contentFreshness: Used to indicate whether the content is new.networkDetails: Used to specify channel metadata.airingDetails: Used to specify start and end times as well as whether content is airing live.
GetDisplayableItemsMetadataResponse Example
The following is an exampleGetDisplayableItemsMetadataResponse from your Lambda that includes badging.
Payload Description
| Field | Description | Data Type |
|---|---|---|
recordingoptional | Information related to recording. The current structure only has a single field for status. The reason for making this a structure and not a standalone field is because Alexa Skills Kit may want to add some more information to the recording structure in the future. Having it available as an object allows Alexa Skills Kit to group these items and make it extensible for the future requirements. | Object |
status (recording)optional | Recording status for the content. The following enum values are allowed:
RECORDED, RECORDING, SCHEDULED | String |
contentFreshnessoptional | Details about content freshness. | Object |
state (contentFreshness)optional | Whether this content is new for the provider that Alexa is fetching results from. The only enum value allowed is NEW — this means that the content is new and airing for the first time on the provider.Example: NEW | String |
networkDetailsoptional | Network details gives information about the network the program is airing from. For example, a new episode of “The Big Bang Theory” airing from CBS, or a live soccer game airing from ESPN. For on-demand content, this could be, for example, Prime Video displaying Game of thrones results from HBO. If the result item represents a live show (contentType = LIVE) on a channel, this object contains its metadata. | List |
isLiveBroadcastoptional | Whether this content is airing in real time. Set this true for live events like watching an NFL football game, or award shows like Oscars or Emmys, etc., that are happening in real time.Set this false for content that was filmed prior to the original airing time. For example, a new episode of Big Bang theory that airs every Thursday. This must also be set to false for content that was once streamed in real time, like a football game in the past, but is no longer happening in real time.Examples: true, false | boolean |
GetPlayableItemsMetadataResponse Example
The samenetworkDetails structure used in GetDisplayableItemsMetadata is also used for GetPlayableItemsMetadata. Here’s a sample GetPlayableItemsMetadataResponse response:

