Requirements for Specific Device Types

Note: Sign in to the developer console to build or publish your skill.

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. 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.	`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.

Important: Amazon prohibits the use of Alexa.SceneController and Alexa.RangeController with semantics in home security devices.

Example devices	Required functionality	Required Alexa capability interfaces
Battery-powered camera	Retrieve the camera stream, report consumption of supplies. Your device must support audio in full or half-duplex mode.	`Alexa.InventoryLevelSensor`, `Alexa.RTCSessionController`, `Alexa.SmartVision.ObjectDetectionSensor`, `Alexa.SmartVision.SnapshotProvider`
Battery-powered door lock	Set lock, unlock, report consumption of supplies.	`Alexa.LockController`, `Alexa.InventoryLevelSensor`
Camera	Retrieve the camera stream. Your device must support audio in full or half-duplex mode.	`Alexa.RTCSessionController`, `Alexa.SmartVision.ObjectDetectionSensor`, `Alexa.SmartVision.SnapshotProvider`
Doorbell	Capture doorbell events. Your device must support audio in full or half-duplex mode.	`Alexa.DoorbellEventSource`, `Alexa.RTCSessionController`
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.

Important: Amazon prohibits the use of SceneController in kitchen and cooking devices.

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.

Important: Amazon prohibits the use of SceneController in sensor device skills.

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, such as blinds and shades.

Example devices	Required functionality	Required Alexa capability interfaces
Exterior and interior blinds	Open and close blinds.	At least one of `Alexa.ModeController`, `Alexa.ModeController` with semantics, `Alexa.RangeController`, or `Alexa.RangeController` with semantics
Shades	Open and close shades.	At least one of `Alexa.ModeController`, `Alexa.ModeController` with semantics, `Alexa.RangeController`, or `Alexa.RangeController` with semantics