General device requirements
To qualify 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 Supported device categories and required interfaces for your device categories. If you need clarification on which capabilities fit your device, contact Alexa developer support or your Amazon representative. Your device must support its primary functionality through Alexa. You can’t certify a device based solely on secondary features. For example, a smart pet feeder with a built-in sensor or camera must support pet feeding functions through Alexa, such as portion sizes, feeding schedules, and manual dispensing. Amazon can’t certify the pet feeder as a camera or sensor device only. 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 and Change Reporting.
- You must include
manufacturerandmodelin the additionalAttributes object in the discovery response. To help Alexa 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
EndpointHealthproperties as you can.
Requirements for hubs
To receive WWA certification, a hub must connect smart home devices to Alexa.Supported device categories and required interfaces
Review the mandatory interfaces for your device category. If your device connects to Alexa with Matter, make sure that your product also 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 device | Required feature | 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. For air purifiers that connect to Alexa with ACK, smart home add-ons, or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | 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. Your device must support both Celsius and Fahrenheit temperature scales. Your device 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 |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Control device settings within a minimum and maximum range, such as speed of a fan. | Alexa.RangeController |
| Detect and report temperature. | Alexa.TemperatureSensor |
| Toggle device settings other than power. | Alexa.ToggleController |
Entertainment
The following table shows the required capability interfaces for devices in the entertainment category.| Example device | Required feature | 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, select input, turn on power, turn off power. | Alexa.ChannelController, Alexa.InputController, Alexa.PowerController |
| Set-top box | Set channel, set and adjust volume, mute, unmute, select input, 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.PlaybackController, Alexa.PowerController, Alexa.RemoteVideoPlayer.SearchAndDisplay, Alexa.RemoteVideoPlayer.SearchAndPlay |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Turn on power, turn off power. | Alexa.PowerController |
| Start and stop recording content | Alexa.RecordController |
| Navigate to a specific position in a media item. | Alexa.SeekController |
| Find, schedule, cancel a recording. | Alexa.VideoRecorder |
Home office
The following table shows the required capability interfaces for devices in the home office category.| Example device | Required feature | Required Alexa capability interfaces |
|---|---|---|
| Printer | Turn on power, turn off power, report consumption of supplies. For printers that connect to Alexa with ACK, smart home add-ons, Internet Printing Protocol (IPP), or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | Alexa.PowerController, Alexa.InventoryLevelSensor |
| Router | Enable network access, disable network access. For details about supported utterances, see Wi-Fi router device template. | Alexa.ToggleController |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Set device to one of a list of mode values. | Alexa.ModeController |
Home security
The following table shows the required capability interfaces for devices in the home security category.| Example device | Required feature | 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. For non-rechargeable, battery-powered cameras that connect to Alexa with ACK, smart home add-ons, or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | Alexa.InventoryLevelSensor, Alexa.RTCSessionController, Alexa.SmartVision.ObjectDetectionSensor, Alexa.SmartVision.SnapshotProvider |
| Battery-powered door lock | Set lock, unlock, report consumption of supplies. For non-rechargeable, battery-powered door locks that connect to Alexa with ACK, smart home add-ons, or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | 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, Alexa.SmartVision.ObjectDetectionSensor, Alexa.SmartVision.SnapshotProvider |
| 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 |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Report object detection from devices with a camera. | Alexa.SmartVision.ObjectDetectionSensor |
| Send snapshot images from devices with a camera. | 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 device | Required feature | Required Alexa capability interfaces |
|---|---|---|
| Aroma diffuser | Turn on power, turn off power. | Alexa.PowerController |
| Robotic lawnmower | Turn on power, turn off power, return to charging base. Amazon requires robotic lawnmowers to have built-in support for object sensing. When the device detects an obstacle, it must either re-route (recommended) or pause operation. Robotic lawnmowers are not supported in Alexa Routines. | Alexa.PowerController,Implement return to base with Alexa.PowerController.TurnOff directive or Alexa.ModeController with semantics. |
| Robotic 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 device | Required feature | 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 device | Required feature | Required Alexa capability interfaces |
|---|---|---|
| Dimmer, dimmable light, dimmable plug | Turn on power, turn off power, Control the brightness of the device. | Alexa.PowerController, Alexa.BrightnessController |
| Lamp, light bulb, light strip, outlet, plug, power strip, switch | Turn on power, turn off power. | Alexa.PowerController |
| Light bulb or light strip with color control | Turn on power, turn off power, Change the color of the device. | Alexa.PowerController, Alexa.ColorController |
| Light bulb or light strip with color temperature control | Turn on power, turn off power, Change the color temperature (shade of white) of the device. | Alexa.PowerController, Alexa.ColorTemperatureController |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Set the percentage value of the device. | Alexa.PercentageController |
| Control the power level of the device. | Alexa.PowerLevelController |
Sensors
The following table shows the required capability interfaces for devices in the sensors category.| Example device | Required feature | Required Alexa capability interfaces |
|---|---|---|
| Battery-powered contact sensor | Detect and report contact, report consumption of supplies. For non-rechargeable, battery-powered contact sensors that connect to Alexa with ACK, smart home add-ons, or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | Alexa.ContactSensor, Alexa.InventoryLevelSensor |
| Battery-powered motion sensor | Detect and report motion, report consumption of supplies. For non-rechargeable, battery-powered motion sensors that connect to Alexa with ACK, smart home add-ons, or local control (non-Matter), your product must receive Dash certification in supported marketplaces. | Alexa.MotionSensor, Alexa.InventoryLevelSensor |
| Contact sensor | Detect and report contact. | Alexa.ContactSensor |
| Motion sensor | Detect and report motion. | Alexa.MotionSensor |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Detect and report humidity. | Alexa.HumiditySensor |
Window treatments
The following table shows the required capability interfaces for devices in the window treatments category, such as blinds and shades.| Example device | Required feature | 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 |
| Optional feature | Required Alexa capability interfaces |
|---|---|
| Turn on power, turn off power. | Alexa.PowerController |
| Control the power level of the device. | Alexa.PowerLevelController |
| Activate or deactivate multiple smart home devices grouped together into a scene. | Alexa.SceneController |
| Toggle device settings other than power. | Alexa.ToggleController |
