Requirements for Specific Device Types


To receive Works with Alexa (WWA) certification, your device must meet the following requirements for your device type. These requirements apply to products that connect to Alexa with an Alexa smart home skill and the Alexa Connect Kit (ACK), and products that have Alexa built-in. Hubs that integrate other smart home devices with Alexa are also eligible for WWA certification.

For the complete list of smart home interfaces, see List of Alexa Interfaces and Supported Languages.

General device requirements

Your device must implement the capability interfaces for the features that your product supports. To be eligible for certification, your device must support the required interfaces specified for your device category. Some device types have no required capability interfaces. For details, see the required capability interfaces for your device category.

In addition, your device must meet the following requirements:

  • All devices must support device discovery and state reporting. For details, see Alexa.Discovery and Understand State Reporting.
  • You must include manufacturer and model in the additionalAttributes object in the discovery response. For Alexa to identify unique devices, include as many other attributes as you can.
  • To let Alexa know the health of your device, implement EndpointHealth. As a best practice, support as many EndpointHealth properties as you can.

Requirements for hubs

To receive WWA certification, a hub must connect smart home devices to Alexa.

Required capability interfaces

Review the mandatory interfaces for your device category. If your device connects to Alexa with Matter, make sure that your product supports the required Matter clusters for your device category.

Climate control

The following table shows the required capability interfaces for devices in the climate control category.

Example devices Required functionality Required Alexa capability interfaces

Air conditioner

Set temperature, query current temperature

Alexa.ThermostatController

Air filter

Turn on power, turn off power

Alexa.PowerController

Air purifier

Turn on power, turn off power, report consumption of supplies

Alexa.PowerController and one of Alexa.InventoryLevelSensor or Alexa.InventoryLevelUsageSensor

Fan

Turn on power, turn off power

Alexa.PowerController

HVAC unit

Set temperature, query current temperature

Alexa.ThermostatController

Thermostat

Set temperature, query current temperature

Alexa.ThermostatController

If your product supports any of the following optional climate control features, specify the capabilities when you register your product:

Entertainment

The following table shows the required capability interfaces for devices in the entertainment category.

Example devices Required functionality Required Alexa capability interfaces

Amplifier

Set and adjust volume, mute, unmute, select input

Alexa.Speaker, Alexa.InputController

Game consoles

Set channel, launch UI shortcuts and apps, search video, search and play video

Alexa.ChannelController, Alexa.Launcher, Alexa.PlaybackStateReporter, Alexa.RemoteVideoPlayer.SearchAndDisplay, Alexa.RemoteVideoPlayer.SearchAndPlay

Projector

Turn on power, turn off power

Alexa.PowerController

Receiver

Set and adjust volume, mute, unmute, select input

Alexa.Speaker, Alexa.InputController

Remote control

Set channel, set and adjust volume, mute, unmute, turn on power, turn off power

Alexa.ChannelController, Alexa.InputController, Alexa.PowerController

Set-top box

Set channel, set and adjust volume, mute, unmute, launch UI shortcuts and apps, turn on power, turn off power, search video, search and play video

Alexa.ChannelController, Alexa.InputController, Alexa.Launcher, Alexa.PlaybackStateReporter, Alexa.PowerController, Alexa.RemoteVideoPlayer.SearchAndDisplay, Alexa.RemoteVideoPlayer.SearchAndPlay

Sound bar

Play device, stop device, pause device, set and adjust volume, mute, unmute

Alexa.PlaybackController, Alexa.Speaker

Speaker

Play device, stop device, pause device, set and adjust volume, mute, unmute

Alexa.PlaybackController, Alexa.Speaker

Subwoofer

Set equalizer bands, set sound modes

Alexa.EqualizerController

Television

Set channel, set and adjust volume, mute, unmute, launch UI shortcuts and apps, turn on power, turn off power, search video, search and play video

Alexa.ChannelController, Alexa.InputController, Alexa.Launcher, Alexa.PlaybackStateReporter, Alexa.PowerController, Alexa.RemoteVideoPlayer.SearchAndDisplay, Alexa.RemoteVideoPlayer.SearchAndPlay

If your product supports any of the following optional entertainment features, specify the capabilities when you register your product:

Home office

The following table shows the required capability interfaces for devices in the home office category.

Example devices Required functionality Required Alexa capability interfaces

Printer

Turn on power, turn off power, report consumption of supplies

Alexa.PowerController, Alexa.InventoryLevelSensor

Router

Enable network access, disable network access
For details about supported utterances, see Wi-Fi router device template.

Alexa.ToggleController

If your product supports any of the following optional home office features, specify the capabilities when you register your product:

Home security

The following table shows the required capability interfaces for devices in the home security category.

Example devices Required functionality Required Alexa capability interfaces

Battery-powered camera

Retrieve camera stream, report consumption of supplies

Alexa.CameraStreamController, Alexa.InventoryLevelSensor

Battery-powered door lock

Set lock, unlock, report consumption of supplies

Alexa.LockController, Alexa.InventoryLevelSensor

Camera

Retrieve camera stream

Alexa.CameraStreamController

Doorbell

Capture doorbell events

Alexa.DoorbellEventSource

Door lock

Set lock, unlock

Alexa.LockController

Garage door opener

Open garage door, close garage door

Alexa.ModeController with semantics

Security panel

Arm security system, disarm security system

Alexa.SecurityPanelController

If your product supports any of the following optional security features, specify the capabilities when you register your product:

Household and personal care

The following table shows the required capability interfaces for devices in the household and personal care category.

Example devices Required functionality Required Alexa capability interfaces

Aroma diffuser

Turn on power, turn off power

Alexa.PowerController

Vacuum

Turn on power, turn off power, return to charging base,

Alexa.PowerController,
Implement return to base with Alexa.PowerController.TurnOff directive or Alexa.ModeController with semantics.

Kitchen and cooking appliances

The following table shows the required capability interfaces for devices in the kitchen and cooking appliances category.

Example devices Required functionality Required Alexa capability interfaces

Microwave

Start and stop cooking, change cooking mode, cook by time, pause cooking, resume cooking

Alexa.Cooking.TimeController, Alexa.TimeHoldController

Lighting and power

The following table shows the required capability interfaces for devices in the lighting and power category.

Example devices Required functionality Required Alexa capability interfaces

Dimmer

Turn on power, turn off power

Alexa.PowerController

Lamp

Turn on power, turn off power

Alexa.PowerController

Light bulb

Turn on power, turn off power

Alexa.PowerController

Light strip

Turn on power, turn off power

Alexa.PowerController

Plug

Turn on power, turn off power

Alexa.PowerController

Power strip

Turn on power, turn off power

Alexa.PowerController

Switch

Turn on power, turn off power

Alexa.PowerController

If your product supports any of the following optional features, specify the capabilities when you register your product:

Sensors

The following table shows the required capability interfaces for devices in the sensors category.

Example devices Required functionality Required Alexa capability interfaces

Battery-powered contact sensor

Detect and report contact, report consumption of supplies

Alexa.ContactSensor, Alexa.InventoryLevelSensor

Battery-powered motion sensor

Detect and report motion, report consumption of supplies

Alexa.MotionSensor, Alexa.InventoryLevelSensor

Contact sensor

Detect and report contact

Alexa.ContactSensor

Motion sensor

Detect and report motion

Alexa.MotionSensor

Window Treatments

The following table shows the required capability interfaces for devices in the window treatments category.

Example devices Required functionality Required Alexa capability interfaces

Exterior and interior blinds

Open and close blinds

Alexa.ToggleController

Shades

Open and close shades

Alexa.ToggleController

If your product supports any of the following optional features, specify the capabilities when you register your product:


Was this page helpful?

Last updated: Jul 23, 2024