Do you use Zigbee switches and buttons from brands like Ikea, Opple, Aqara, or Xiaomi to control your smart lights? These popular and affordable options are perfect for smart home enthusiasts, but when Zigbee2MQTT upgraded to version 2.0 in 2025, many existing configurations stopped working.
The problem? Clicks were converted into event types, breaking compatibility with older setups.
To solve this, I created a universal setup for Zigbee2MQTT 2.0 that works with all kinds of switches and buttons. My goal was simple: to help others save time and effort in configuring their devices.
The guide is available on my GitHub and has been shared with the Home Assistant community for feedback and ideas.
With your input, we can make it even better and more versatile!
1 setup for every switch in zigbee2mqtt 2.0 and above!
Contents
How to install the blueprint?
Or import this url:
https://github.com/remb0/blueprints/blob/main/Different_switches_zigbee2mqtt.yaml
Using the blueprint via the UI
To configure your setup via the UI, go to Settings > Automations & Scenes > Configurations.
Find the Motion Light Tutorial guide and select Create Automation.
Important
Don’t forget to reload automations after you make changes to your setup to have the UI and the automation integration pick up the latest changes.
Update the Blueprint
If the guide is updated on GitHub, you have to re-import it and reload configurations in Home Assistant:
Go to Settings > automations and scenes.
Go to Configurations on the top bar.
search for the guide of remb0 and click on the 3 dots on the end of the line.
Click the Reload/import Configurations .
If necessary, reapply the guide to an automation:
Navigate to Settings > Automations & Scenes.
Select the automation using the guide.
Make any required updates and save.
Compatible switches
ikea
xiaomi and opple Available at: Aliexpress
Philips
For a actual list please check out the github page.
How to contribute to the blueprint
Raise a issue, ask a question or make a pull request at gihub (https://github.com/remb0/blueprints/tree/main/)
To add new devices:
give the brand, model, and options/event types
(in develop tools, like: event_types: hold, button_1_release, button_1_single, button_1_double, button_1_triple, button_2_release, button_2_single, button_2_double, etc. etc…)
https://github.com/remb0/blueprints/issues/new?template=new-device-request.md
-
Design
-
Quality
-
Usability
-
Home-Automation compatibility
-
Price