Back to the overview

Matter in Home Assistant

matter part of Home Assistant since 2022.12

Local, push Set up in the user interface

The Matter integration connects Home Assistant to smart devices via a hub, supporting lighting, climate control, security, and more. It uses local network communication and is set up through the user interface with automatic discovery.

Typical uses

  • Home automation
  • Remote device control
  • Energy management
  • Security monitoring

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
219,097 (32.1 % 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.4.0, matter-ble-proxy==0.7.1

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for Matter.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

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 ♥ 119 · Import · Forum
  • Automation IKEA ALPSTUGA E2495 Air Quality Sensor (Matter) v2.1 ♥ 14 · Import · Forum
  • Automation Inovelli Matter Switch Tap Sequences ♥ 7 · Import · Forum
  • Automation Aqara H2 4-Button Custom Actions ♥ 7 · Import · Forum
  • Automation Matter - IKEA SOMRIG Shortcut Button (Model E2213) V1.0 ♥ 4 · Import · Forum
  • Automation Matter - IKEA STYRBAR Remote control (Model E2002) V1.0 ♥ 1 · Import · Forum

All blueprints for it

Known issues and fixes

50 open issues and 54 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.9.0.

Open

  • open The IKEA BILRESA Scroll wheel is recognized as a button but does not handle multi-press actions correctly. Affects: IKEA BILRESA since December 14, 2025 · 62 reactions · 9 comments · #159035
  • open A Matter vacuum robot causes incorrect repair notifications about changed segments. since March 3, 2026 · 5 reactions · 37 comments · #164652
  • open Re-pairing a Matter device creates a duplicate entry in Home Assistant. since December 11, 2025 · 4 reactions · 17 comments · #158751
  • open Matter entities are incorrectly assigned to other Matter devices. since February 8, 2026 · 3 reactions · 7 comments · #162519
  • open The Matter integration stops working after updating to a recent version. since May 6, 2026 · 2 reactions · 18 comments · #169938
  • open The IKEA ALPSTUGA air quality monitor is displayed as an outlet instead of a sensor. Affects: IKEA ALPSTUGA since December 13, 2025 · 2 reactions · 9 comments · #158943
  • open After pairing a Matter device, the dialog to set its name or area does not appear. since July 31, 2026 · 1 reaction · 6 comments · #177694
  • open The Aqara A100 lock does not show who or how the lock was opened. Affects: Aqara A100 since December 19, 2025 · 1 reaction · 6 comments · #159410

Fixed

  • fixed in 2026.9.0 A fan was turning on with an invalid value that caused it to malfunction. Fix #180541 · Issue #180537
  • fixed in 2026.9.0 The device class for a thermostat's temperature offset was incorrect. Fix #180535 · Issue #180534
  • fixed in 2026.9.0 Temperature offset values for thermostats had incorrect unit conversions. Fix #180172 · Issue #162440
  • fixed in 2026.9.0 A Matter lock did not accept a templated PIN for credential setup. Fix #180482 · Issue #180480
  • fixed in 2026.9.0 An IKEA air quality sensor switch was incorrectly classified as a config entity. Affects: IKEA air quality sensor Fix #179546
  • fixed in 2026.8.2 Devices connected through a Matter bridge lost their 'via device' information. Fix #179118 · Issue #179026
  • fixed in 2026.8.1 Cover state updates were delayed or split due to coalesced attribute changes. Fix #177540
  • fixed in 2026.8.0 A race condition caused the 'via device' information to be lost in some cases. Fix #177936
  • fixed in 2026.6.0 Stale BLE advertisements were processed incorrectly by the Matter BLE proxy. Fix #172773
  • fixed in 2026.6.0 The Matter BLE proxy prevented the system from starting up properly. Fix #172456 · Issue #172380
  • fixed in 2026.5.2 Fractional temperature setpoints in climate devices were not rounded correctly. Fix #170442
  • fixed in 2026.5.0 Fan speed settings were not exposed correctly using the PercentSetting attribute. Fix #169696 · Issue #156285

Source: the issue tracker of Home Assistant, as of September 13, 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.

Scroll to Top