Zigbee Home Automation in Home Assistant
zha
part of Home Assistant since 0.44
Connects Home Assistant to Zigbee devices through a hub or gateway, enabling integration of sensors, lights, climate controls, and more. It uses local polling for device communication and is set up via the user interface.
Typical uses
- home security automation
- smart lighting control
- climate control
- environmental monitoring
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
- 144,890 (20.1 % of the installations that share statistics)
- Categories
- Alarm, Binary sensor, Button, Climate, Cover, Device tracker, Event, Fan, Hub, Infrared, Light, Lock, Number, Select, Sensor, Siren, Switch, Update, Valve
- Provides
- Alarm control panel, Binary sensor, Button, Climate, Cover, Device tracker, Diagnostics, Event, Fan, Infrared, Light, Lock, Number, Select, Sensor, Siren, Switch, Update, Valve
- Found automatically via
- Network discovery (Zeroconf), USB
- Maintained by
- @dmulcahey, @adminiuga, @puddly, @TheJulianJES
- Python packages
zha==2.4.2, zha-quirks==2.4.0
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 – Controls IKEA STYRBAR remote using input text, MQTT, ZHA, or Deconz integrations.
- Automation ZHA - Philips Hue Dimmer Switch – Controls Philips Hue dimmer switch via ZHA, adjusting light entities based on sensor input.
- Automation IKEA Rodret Dimmer Controls (ZHA/Z2M) – Controls IKEA Rodret dimmer via ZHA integration, compatible with Zigbee and Zigbee2MQTT.
- Automation Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote – Controls IKEA TRÅDFRI 5-button remote using input text, MQTT, ZHA, or Deconz integrations.
- Automation ZHA - IKEA five button remote for lights – Uses a ZHA-enabled IKEA remote to control lights, requiring ZHA integration and light entities.
- Automation Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer – Configures input text for IKEA switch and dimmer control via MQTT, ZHA, and Deconz integrations.
Known issues and fixes
45 open issues and 26 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.10.1.
Open
- open The LED on the ZBT-2 device does not function as expected because some entities are missing. Affects: Silabs series 2 router
- open There is no option to exclude ZHA-related events from appearing in the Logbook.
- open The ZHA application controller fails to start, preventing device communication.
- open The ZHA integration becomes stuck during the initialization process and does not proceed further.
- open Reported problem #188325 Affects: SONOFF ZBMINIL2 SONOFF ZBMINIR2
- open Zigbee device communication issues began after a software update and persist in later versions.
- open The SLZB-06MU ESP32 bridge causes communication timeouts with Zigbee devices when forming a network. Affects: Silabs series 2 router
- open ZHA intermittently fails to control Zigbee blinds, resulting in 'device did not respond' errors.
Fixed
- fixed in 2026.10.1 The ZHA integration did not properly send results for reconfiguration actions via the websocket.
- fixed in 2026.10.0 The ZHA integration failed to correctly apply LED effects from Inovelli devices during actions.
- fixed in 2026.7.2 ZHA device triggers did not correctly resolve device-specific quirks from the cache.
- fixed in 2026.5.4 ZHA incorrectly blocked downgrading to minor versions of the integration.
- fixed in 2026.5.3 ZHA configuration entries using a URI without a specified port caused connection issues.
- fixed in 2026.3.0 ZHA update entities did not function correctly after reloading the integration.
- fixed in 2026.2.2 The ZHA integration was updated to version 0.0.90, which may include bug fixes and improvements.
- fixed in 2026.2.0 The ZHA integration was updated to version 0.0.88, which may include bug fixes and improvements.
- fixed in 2025.12.1 ZHA displayed incorrect status messages related to the adapter's state.
- fixed in 2025.12.1 An error message was not displayed when the formation of a new ZHA network failed.
- fixed in 2025.12.0 Bug fix #157769
- fixed in 2025.11.1 Bug fix #155867
Source: the issue tracker of Home Assistant, as of November 2, 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
The description was written by a language model from the facts listed here, not taken from the documentation.