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
andmodel
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 | |
Air filter |
Turn on power, turn off power | |
Air purifier |
Turn on power, turn off power, report consumption of supplies |
|
Fan |
Turn on power, turn off power | |
HVAC unit |
Set temperature, query current temperature | |
Thermostat |
Set temperature, query current temperature Note: Starting February 7, 2025, to receive WWA certification, you must support at least one of
HEAT or COOL ThermostatMode values and include the list of thermostat modes in the configuration.supportedModes property in the discovery response. For more details, see 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 | |
Game consoles |
Set channel, launch UI shortcuts and apps, search video, search and play video |
|
Projector |
Turn on power, turn off power | |
Receiver |
Set and adjust volume, mute, unmute, select input | |
Remote control |
Set channel, set and adjust volume, mute, unmute, turn on power, turn off power |
|
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 |
|
Sound bar |
Play device, stop device, pause device, set and adjust volume, mute, unmute | |
Speaker |
Play device, stop device, pause device, set and adjust volume, mute, unmute | |
Subwoofer |
Set equalizer bands, set sound modes | |
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 |
|
If your product supports any of the following optional entertainment features, specify the capabilities when you register your product:
Alexa.ChannelController
Alexa.EqualizerController
Alexa.InputController
Alexa.PlaybackController
Alexa.PowerController
Alexa.RecordController
Alexa.SeekController
Alexa.Speaker
Alexa.VideoRecorder
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 | |
Router |
Enable network access, disable network access |
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.
Alexa.SceneController
and Alexa.RangeController
with semantics in home security devices.Example devices | Required functionality | Required Alexa capability interfaces |
---|---|---|
Battery-powered camera |
Retrieve camera stream, report consumption of supplies Note: Starting February 7, 2025, you must use
Alexa.SmartVision.SnapshotProvider to receive WWA certification for camera devices. For more details about supported interfaces, see Camera device template. |
|
Battery-powered door lock |
Set lock, unlock, report consumption of supplies | |
Camera |
Retrieve camera stream Note: Starting February 7, 2025, you must use
Alexa.SmartVision.SnapshotProvider to receive WWA certification for camera devices. For more details about supported interfaces, see Camera device template. |
|
Doorbell |
Capture doorbell events Note: Starting February 7, 2025, you must use
Alexa.RTCSessionController to receive WWA certification for video doorbells. | |
Door lock |
Set lock, unlock | |
Garage door opener |
Open garage door, close garage door | |
Security panel |
Arm security system, disarm security system |
If your product supports any of the following optional security features, specify the capabilities when you register your product:
Alexa.CameraStreamController
Alexa.DoorbellEventSource
Alexa.RTCSessionController
Alexa.SmartVision.ObjectDetectionSensor
Alexa.SmartVision.SnapshotProvider
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 | |
Vacuum |
Turn on power, turn off power, return to charging base, |
|
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 |
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 | |
Lamp |
Turn on power, turn off power | |
Light bulb |
Turn on power, turn off power | |
Light strip |
Turn on power, turn off power | |
Plug |
Turn on power, turn off power | |
Power strip |
Turn on power, turn off power | |
Switch |
Turn on power, turn off power |
If your product supports any of the following optional features, specify the capabilities when you register your product:
Alexa.BrightnessController
Alexa.ColorController
Alexa.ColorTemperatureController
Alexa.PercentageController
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 | |
Battery-powered motion sensor |
Detect and report motion, report consumption of supplies | |
Contact sensor |
Detect and report contact | |
Motion sensor |
Detect and report motion |
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 | |
Shades |
Open and close shades |
If your product supports any of the following optional features, specify the capabilities when you register your product:
Alexa.ModeController
Alexa.ModeController
with semanticsAlexa.PowerController
Alexa.PowerLevelController
Alexa.RangeController
Alexa.RangeController
with semanticsAlexa.SceneController
Related topics
- Apply for Works with Alexa Certification
- Get Started with Device Templates
- Works with Alexa Security Best Practices
Last updated: Dec 19, 2024