Adding a Zigbee device to Home Assistant allows you to control smart lights, sensors, plugs, switches, and other devices from one place.
This can be done using ZHA, Zigbee2MQTT, or another Zigbee integration.
Fortunately, the process is simple if your Zigbee coordinator is already connected.
These include opening your Zigbee integration, putting the device in pairing mode, waiting for Home Assistant to find it, and assigning it to a room.
In this guide, you will learn how to add a Zigbee device to Home Assistant, what to do if the device does not appear, and additional troubleshooting tips if pairing does not work.
How To Add A Zigbee Device To Home Assistant
1. Check Your Zigbee Coordinator
Before adding a Zigbee device, make sure your Zigbee coordinator is working.
Open Home Assistant.
Go to Settings.
Select Devices & Services.
Check if ZHA or Zigbee2MQTT is running.
Make sure your Zigbee dongle is connected.
Restart Home Assistant if the coordinator is not detected.
2. Open Your Zigbee Integration
You need to open the Zigbee integration before pairing the device.
Open Home Assistant.
Go to Settings > Devices & Services.
Select ZHA or Zigbee2MQTT.
Click Add Device or Permit Join.
Keep this page open while pairing the device.
3. Put the Zigbee Device Into Pairing Mode
Most Zigbee devices must be reset before Home Assistant can find them.
Check the device manual.
Hold the reset button for a few seconds.
For bulbs, turn them on and off several times if required.
Wait for the light to blink or the device to show pairing mode.
Keep the device close to your Zigbee coordinator during pairing.
4. Wait for Home Assistant to Find the Device
Home Assistant may take a few seconds to detect the device.
Wait while Home Assistant scans for new Zigbee devices.
Do not close the pairing page.
Keep the device powered on.
Once the device appears, select it.
Follow the on-screen steps.
5. Rename the Device
Renaming the device makes it easier to find later.
Click the new Zigbee device.
Change the device name.
Use a simple name like Bedroom Light or Kitchen Plug.
Assign the device to the correct room.
Click Save.
6. Test the Zigbee Device
After adding the device, check if it works properly.
Open the device page in Home Assistant.
Turn the device on or off if it is a light or plug.
Check sensor values if it is a sensor.
Wait a few minutes if the values do not update immediately.
Make sure the device responds normally.
7. Move the Device to Its Final Location
Once paired, move the device where you want to use it.
Unplug or move the device carefully.
Place it in the final location.
Wait for it to reconnect.
Test it again from Home Assistant.
Add a Zigbee router device if the signal is weak.
8. Try Pairing Again If It Fails
Sometimes Zigbee devices do not pair on the first try.
Reset the Zigbee device again.
Move it closer to the coordinator.
Restart ZHA or Zigbee2MQTT.
Click Add Device again.
Try pairing one more time.
Conclusion
Adding a Zigbee device to Home Assistant is simple once your Zigbee coordinator is working.
You only need to open ZHA or Zigbee2MQTT, put the device in pairing mode, and wait for Home Assistant to detect it.
If pairing fails, resetting the device, moving it closer, or restarting the Zigbee integration can help.
Additional Reading
How To Fix Home Assistant Zigbee Devices Unavailable
How To Fix Zigbee Device Not Pairing With Home Assistant
How To Fix Zigbee2MQTT Not Working With Home Assistant
Brianna is based in Minnesota in the US at the moment, and has been writing since 2017. She is currently a 3rd Year med student at the time of writing this.
