The most recent update to Zigbee2MQTT has introduced the ability for Zigbee groups to be auto-discovered by Home Assistant using MQTT Discovery. This new addition applies to lights, switches, covers, and locks and will make an optimized self-hosted Zigbee setup much easier to achieve, especially for those wanting to avoid the configuration files.


Zigbee groups have long been supported by Zigbee2MQTT and are a great way of reducing Zigbee traffic and thus improving both its own and co-existing Wi-Fi networks performances. I have extensively written about why you should be using them in a previous article. However, there were still two hurdles many were not willing to overcome: Firstly, Zigbee groups had to be set up using YAML in Zigbee2MQTT’s configuration file and secondly, the configured Zigbee groups weren’t auto-discovered by Home Assistant. What that meant for the user is that Zigbee groups not only had to be created using YAML, but also had to be added to Home Assistant using a configuration file.

The first stumbling blocked was recently solved by the addition of an official web dashboard for Zigbee2MQTT. Using it, Zigbee groups can be created at ease. The second issue was addressed in a feature added in Zigbee2MQTT V1.20.0. With this release, Zigbee groups will automatically be discovered by Home Assistant, as is already the case for devices.


How to create Zigbee groups using Zigbee2MQTT

Gone are the days of having to painstakingly create groups using YAML. Simply open the Zigbee2MQTT dashboard and enter the tab titled groups. There it is possible to create a new group, or add devices to existing groups using a dropdown menu.

The Zigbee2MQTT dashboard showing a list of Zigbee groups

Once the Zigbee group has been created in Zigbee2MQTT, Home Assistant will automatically pick it up using MQTT discovery. Keep in mind that a Zigbee group is not the same as, for example, a light group in Home Assistant. A Zigbee group can be addressed using a single command, whereas the Home Assistant group would still be sending individual commands to the devices in it. The Zigbee group should be used in automations, scripts, and scenes wherever possible.

Other additions to Zigbee2MQTT 1.20.0

While the auto-discovery of Zigbee groups might be the only new major feature included in Zigbee2MQTT 1.20.0, there are a number of improvements, fixes, and newly supported devices included in this release. The latter includes the Philips Hue Lily, Philips Hue Sana, and Philips Hue Flourish. A full changelog can be found in the Zigbee2MQTT repository on GitHub.

Liam Alexander Colman, the author and maintainer of Home Assistant Guides.

About Liam Alexander Colman

Liam Alexander Colman has been using Home Assistant for various projects for quite some time. What started of with a Raspberry Pi quickly became three Raspberry Pis and eventually a full-blown server. I now use Unraid as my operating system and Home Assistant happily runs in a Docker container. My personal setup includes many Zigbee devices as well as integrations with existing products such as my Android TV box. Read on to find out more on how I got started with Home Assistant.

Leave a comment