VisualActivityTracker 1.0

Focus management improves the accuracy of responses from Alexa, specifically, when a user makes an ambiguous request. Focus is managed in the cloud. A client simply informs Alexa which interface has focus of a visual channel. This state information is sent in the context container under the VisualActivityTracker namespace.

See Focus Management for common use cases, and a complete interface to channel mapping.

Capability assertion

VisualActivityTracker 1.0 may be implemented by the device on its own behalf, but not on behalf of any connected endpoints.

New AVS integrations must assert support through Alexa.Discovery, but Alexa will continue to support existing integrations using the Capabilities API.

    "type": "AlexaInterface",
    "interface": "VisualActivityTracker",
    "version": "1.0"


This context object lets Alexa know that the client is actively displaying Alexa-provided content to the user. If the Alexa content has been dismissed, VisualActivityTracker should not be included in the context.

    "header": {
        "namespace": "VisualActivityTracker",
        "name": "ActivityState"
    "payload": {
        "focused": {
            "interface": "{{STRING}}",

Payload Parameters

Parameter Description Type
focused An object that contains information about the interface that currently has visual focus. object
focused.interface Specifies the interface that has visual focus.
Accepted Value: "TemplateRuntime"

Was this page helpful?

Last updated: Nov 27, 2023