Understand Smart Home Matter Support


You can connect your smart home device locally to Alexa using the Matter connectivity protocol. Matter is an Internet Protocol (IP) wireless connectivity technology designed to enable interoperability between devices made by different manufacturers. With Matter, smart home devices can connect directly to Alexa without a separate hub or smart home skill. This connection allows Alexa to control your device locally, reducing latency and improving reliability. For more details about Matter, see the Connectivity Standards Alliance (CSA) introduction to Matter.

Matter-supported Amazon Echo devices can connect and control Matter smart home devices seamlessly. After a customer sets up a compatible Echo, they can add a Matter device using the Alexa app. The Echo device is the Matter administrator used to discover and connect Matter devices to Alexa locally.

If your existing skill connects Matter-enabled devices to Alexa, either native Matter devices or non-Matter devices exposed by a Matter Bridge, you must report Matter attributes from your skill. For details, see Skill requirements for Matter-enabled products.

Specifications

Matter-compatible Echo devices support the Matter 1.3 Software Development Kit (SDK), enabling support for a subset of Matter 1.3 and lower device types. These Echos support smart home devices connected using Matter over Wi-Fi and Matter over Thread. For details about Matter 1.3, see the Matter 1.3 specifications.

Thread is an IPv6 wireless-mesh-networking technology designed for security, reliability, and scalability. The IP-based open-standard mesh network broadens network coverage to keep smart home devices working even if one device goes offline. Thread-enabled Amazon Echo and eero devices act as border routers to provision and secure Thread networks. Before connecting devices using Matter over Thread, a Thread Border Router must commission Thread-based smart home devices. For more details about Thread, see The Thread Group.

Get started with Matter

To get started with Matter, your product should use the latest Matter SDK and be in one of the Alexa-supported device categories. In addition, your product must implement required Matter clusters for your device category. For details, see Supported device categories and cluster types.

Test your Matter integration with a Matter-enabled Echo or eero device. Verify that Alexa can discover and control your device over the local Wi-Fi or Thread network. To test with a local Thread network, you need a Thread-enabled Echo or eero device.

Connection types

Alexa supports the following connection types for Matter devices:

  • You can connect your device directly to Alexa with Matter over Wi-Fi or Matter over Thread. As part of the discovery and commissioning process, Alexa uses Bluetooth Low-Energy (BLE) to pass the credentials of the Wi-Fi or Thread network to your Matter device.
  • You can connect Alexa Connect Kit (ACK) devices to Alexa with the ACK SDK for Matter. The SDK supports Matter over Wi-Fi. For more details, see Introducing ACK SDK for Matter.
  • You can add another connection to Alexa from your skill-connected devices with Matter. This option enables Alexa to control your device locally during Internet outages or when your skill isn't available.
  • You can use the Matter Multi-Admin feature to connect your device to multiple smart home platforms, including Alexa.

These connection types apply to native Matter devices that connect directly to the Matter fabric and non-Matter devices exposed as bridged devices through a Matter bridge.

Obtain the Works with Alexa badge

Works with Alexa (WWA) is a certification program that establishes your product's high-quality compatibility with Alexa. This certification makes sure that customers have a better smart home experience. For details about the WWA program, see Works with Alexa Overview.

Before you apply for WWA certification for your Matter device, your product must implement the Matter clusters for your device category. When you register for WWA certification, select the Alexa capability interfaces that correspond to these clusters as a supported capability. Also, if your product supports any of the optional features and implements the associated Matter clusters, specify the corresponding Alexa capability interfaces when you register your product. For details, see Supported device categories and clusters.

To apply for certification, make sure that your Matter-enabled device meets the Matter requirements for WWA certification. After you have thoroughly tested your product with the Echo or eero device, you can submit your product for WWA certification. For details, see Apply for Works with Alexa Certification.

Compatible Amazon Echo and eero devices

The following Amazon Echo and eero devices support Matter.

The following Amazon Echo and eero devices also have a built-in Thread Border Router.

Supported device categories and clusters

Alexa supports many device types from the following Matter device categories: Matter hubs, lighting and smart plugs, generic buttons, sensors, closure devices (door locks, window coverings), thermostats, fans, air purifiers, appliances (room air conditioners, dishwashers), and robotic vacuums. For details about devices in these categories, see Matter Device Library Specification, Version 1.3.

Matter-enabled Echo and eero devices support Matter clusters in the following device categories. For details about clusters, see Matter Application Clusters, Version 1.3.

Appliances

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the appliances category.

Example device Required feature Required Matter cluster Corresponding Alexa capability interface

Dishwasher

Set mode and operational state, monitor alarms

Dishwasher Mode, Dishwasher Alarm, Operational State, Temperature Control

Alexa.ModeController, Alexa.RangeController

Room air conditioner

Turn on power, turn off power, Set temperature

On/Off, Thermostat

Alexa.PowerController, Alexa.ThermostatController

Closure

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the closure category.

Example device Required feature Required Matter cluster Corresponding Alexa capability interface

Door lock

Set lock, unlock

Door Lock

Alexa.LockController

Window Covering, such as exterior and interior blinds

Open and close blinds

Window Covering

Alexa.ToggleController

Heating, ventilation, and air conditioning (HVAC)

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the HVAC category.

Example device Required feature Required Matter cluster Corresponding Alexa capability interface

Air purifier

Set temperature, monitor temperature, humidity, and air quality, control fan speed, monitor filter status

Thermostat, Temperature Measurement, Relative Humidity Measurement, Air Quality, Fan Control, HEPA Filter Monitoring, Activated Carbon Filter Monitoring

Alexa.ThermostatController, Alexa.TemperatureSensor, Alexa.HumiditySensor, Alexa.RangeController, Alexa.ModeController, Alexa.ToggleController, Alexa.InventoryLevelSensor

Fan

Control the speed of a fan

Fan Control, Fan Controller Capability

Alexa.RangeController, Alexa.ModeController, Alexa.ToggleController

Thermostat

Set temperature, query current temperature

Thermostat

Alexa.ThermostatController, Alexa.ThermostatController.Configuration

Lighting, smart plugs, and outlets

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the lighting and smart plugs/outlets categories. These clusters provide essential functionality for controlling lighting devices, including turning the device on and off, adjusting the brightness levels, and managing color settings, if applicable.

Example device Required feature Required Matter cluster Corresponding Alexa capability interface

On/Off light or plug

Turn on power, turn off power

On/Off

Alexa.PowerController

Dimmable plug

Control the brightness of the device

Level Control

Alexa.BrightnessController

Dimmable light

Control the brightness of the device

Level Control

Alexa.BrightnessController

Lamp

Control the mode settings of the device

Mode Select

Alexa.ModeController

Light bulb with enhanced color control

Change the color (hue, saturation, brightness) of the device

Color Control

Alexa.ColorController

Light strip

Change the color temperature (shade of white)

Color Control

Alexa.ColorTemperatureController

Power strip

Turn on power, turn off power

On/Off

Alexa.PowerController

Robotics

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the robotics category.

Example device Required feature Required Matter cluster Corresponding Alexa capability interface

Robotic vacuum cleaner

Control the mode settings of the device, such as idle, cleaning, mapping.

RVC Run Mode

Alexa.ModeController

Sensors

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the sensors category.

Example device Required feature Required Matter clusters Corresponding Alexa capability interface

Air quality sensor

Monitor and measure ambient air parameters

Air Quality, Temperature Measurement, Relative Humidity Measurement, Carbon Monoxide Measurement, PM2.5 Measurement, Volatile Organic Compounds Measurement

Alexa.TemperatureSensor, Alexa.RangeController, Alexa.ModeController, Alexa.HumiditySensor

Contact sensor

Detect and report contact

Identify, Boolean State

Alexa.ContactSensor

Humidity sensor

Detect and report humidity

Relative Humidity Measurement

Alexa.HumiditySensor

Light sensor

Detect and report the amount of light in an area

Illuminance Measurement

Motion detector

Detect and report motion

Occupancy Sensing

Alexa.MotionSensor

Smoke CO alarm

Sense smoke, carbon monoxide, or both

Smoke CO Alarm, Temperature Measurement, Carbon Monoxide Measurement

Alexa.TemperatureSensor, Alexa.ProactiveNotificationSource

Temperature sensor

Detect and report temperature

Temperature Measurement

Alexa.TemperatureSensor

Switches and Controls

The following table shows the required Matter clusters and associated Alexa capabilities for devices in the switches and controls category.

Example device Required feature Required Matter clusters Corresponding Alexa capability interface

Generic switch (button)

Generic switch

Switch

Alexa.SimpleEventSource


Was this page helpful?

Last updated: Jan 24, 2025