Zigbee Home Automation in Home Assistant
zha
part of Home Assistant since 0.44
Zigbee Home Automation is an official Home Assistant integration for Alarm, Binary sensor, Button, Climate, Cover, Device tracker, Fan, Hub, Light, Lock, Number, Select, Sensor, Siren, Switch and Update. Talks to the device on your own network and asks for changes at regular intervals.
Facts about this integration
- Compatible with Home Assistant
- yes, official integration
- Connection
- Local, polling – Talks to the device on your own network and asks for changes at regular intervals.
- Setup
- in the user interface
- Kind
- Hub – several devices through one gateway or account
- Installations
- 139,678 (20.5 % of the installations that share statistics)
- Categories
- Alarm, Binary sensor, Button, Climate, Cover, Device tracker, Fan, Hub, Light, Lock, Number, Select, Sensor, Siren, Switch, Update
- Provides
- Alarm control panel, Binary sensor, Button, Climate, Cover, Device tracker, Diagnostics, Fan, Light, Lock, Number, Select, Sensor, Siren, Switch, Update
- Found automatically via
- Network discovery (Zeroconf), USB
- Maintained by
- @dmulcahey, @adminiuga, @puddly, @TheJulianJES
- Python packages
zha==2.2.2, zha-quirks==2.2.2
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 Zigbee Home Automation.
- 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.
Blueprints that use this integration
- Automation Controller - IKEA E2001/E2002 STYRBAR Remote control
- Automation ZHA - Philips Hue Dimmer Switch
- Automation IKEA Rodret Dimmer Controls (ZHA/Z2M)
- Automation Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote
- Automation ZHA - IKEA five button remote for lights
- Automation Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer
Known issues and fixes
50 open issues and 32 bug fixes in the last twelve months are recorded for Zigbee Home Automation in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.7.2.
Open
- open Reported problem #157195 Affects: Silabs series 2 router
- open Reported problem #84590
- open Reported problem #130548
- open Reported problem #168432
- open Reported problem #180507
- open Reported problem #180872
- open Reported problem #145584 Affects: Tuya TT001ZAV20
- open Reported problem #135188
Fixed
- fixed in 2026.7.2 Bug fix #175895
- fixed in 2026.5.4 Bug fix #171319
- fixed in 2026.5.3 Bug fix #171164
- fixed in 2026.3.0 Bug fix #164290
- fixed in 2026.2.2 Bug fix #162894
- fixed in 2026.2.0 Bug fix #161904
- fixed in 2025.12.1 Bug fix #158021
- fixed in 2025.12.1 Bug fix #157863
- fixed in 2025.12.0 Bug fix #157769
- fixed in 2025.11.1 Bug fix #155867
- fixed in 2025.11.0 Bug fix #155019
- fixed in 2025.10.3 Bug fix #154397
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 →
Compatible devices
Source of this entry: the official documentation of the integration
