1 blueprint for every switch in zigbee2mqtt 2.0

0
40

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?

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

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