Matter in Home Assistant
matter
part of Home Assistant since 2022.12
The Matter integration connects Home Assistant to smart home devices via a hub, enabling control through a single gateway or account. It supports a wide range of device types, including lights, climate systems, locks, and sensors, using local network communication.
Typical uses
- Control smart lights and climate systems
- Monitor security sensors and locks
- Integrate with voice assistants
- Automate home routines
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, push – Talks to the device on your own network and is told about every change straight away.
- Setup
- in the user interface
- Kind
- Hub – several devices through one gateway or account
- Installations
- 236,076 (32.9 % of the installations that share statistics)
- Categories
- Binary sensor, Button, Car, Climate, Cover, Fan, Light, Lock, Number, Pump, Select, Sensor, Siren, Switch, Update, Vacuum, Valve, Water heater
- Provides
- Binary sensor, Button, Climate, Cover, Diagnostics, Event, Fan, Light, Lock, Number, Select, Sensor, Siren, Switch, Update, Vacuum, Valve, Water heater
- Found automatically via
- Network discovery (Zeroconf)
- Maintained by
- @home-assistant/matter
- Python packages
matter-python-client==1.5.5, matter-ble-proxy==0.7.1
Setup
- Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
- In Home Assistant open Settings → Devices & services.
- Click "Add integration" and search for Matter.
- Follow the dialog – it asks for everything the integration needs.
The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.
Matching add-ons
Add-ons that declare a connection to this integration in their own configuration.
Blueprints that use this integration
- Automation Ikea_bilresa_scroll_wheel – Controls lights, media players, and input selects via an Ikea Bilresa scroll wheel using Matter integration.
- Automation IKEA ALPSTUGA E2495 Air Quality Sensor (Matter) v2.1
- Automation Aqara H2 4-Button Custom Actions – Handles Aqara H2 button events via Matter integration for custom automation actions.
- Automation Inovelli Matter Switch Tap Sequences – Handles tap sequences on a Matter switch, requiring event, light, and fan entities with Matter integration.
- Automation Matter - IKEA SOMRIG Shortcut Button (Model E2213) V1.0 – Triggers actions via Matter integration using IKEA button events. Requires Matter-compatible devices and event setup.
- Automation Matter - IKEA STYRBAR Remote control (Model E2002) V1.0 – Handles Matter events from an IKEA STYRBAR remote, using event entities and Matter integration for control.
Known issues and fixes
46 open issues and 67 bug fixes in the last twelve months are recorded for Matter in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.11.0.
Open
- open The scroll wheel on IKEA BILRESA is recognized as a button but does not handle multi-press actions correctly. Affects: IKEA BILRESA
- open A Matter vacuum robot causes repair alerts about changed segments in the Home Assistant interface.
- open Re-pairing a Matter device creates a duplicate entry in Home Assistant.
- open Matter integration does not support transitioning lights to the off state smoothly.
- open Matter entities are incorrectly moved to other Matter devices in Home Assistant.
- open IKEA MYGGBETTT and MYGGSPRAY Matter devices frequently lose connection with Home Assistant. Affects: IKEA MYGGBETTT and MYGGSPRAY
- open Commissioning a Matter device via the Companion app gets stuck during network connectivity checks.
- open Adjusting brightness on a light without turning it on is not supported in the Matter integration.
Fixed
- fixed in 2026.11.0 Bug fix #189804
- fixed in 2026.10.1 Bug fix #182808
- fixed in 2026.10.0 Hisense AC (0x138C/0x3601) was added to the lists of Matter devices supporting dry and fan modes. Affects: Hisense AC
- fixed in 2026.10.0 Matter air quality sensors now report 'unknown' for values outside the specified range.
- fixed in 2026.9.3 Matter cover entities for Shelly devices were not created when the tilt attribute was missing.
- fixed in 2026.9.0 Matter fans sent invalid percentage settings when turning on.
- fixed in 2026.9.0 Matter thermostats had incorrect device classes for temperature offset numbers.
- fixed in 2026.9.0 Matter thermostats incorrectly converted temperature offset minimum and maximum values.
- fixed in 2026.9.0 Matter locks could not use templated PINs for credentials.
- fixed in 2026.9.0 IKEA air quality sensor switches were incorrectly classified as non-configuration entities.
- fixed in 2026.8.2 Composed devices behind a Matter bridge lost their 'via device' relationship.
- fixed in 2026.8.1 Matter cover state updates were not debounced, causing split attribute updates.
Source: the issue tracker of Home Assistant, as of November 1, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.
Check a specific device for known problems in the product check →
Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.