SONOFF MINI-ZB2GS in Home Assistant
Wall switches · Zigbee · Zigbee dual-channel smart switch
This device is known to both Zigbee integrations: Zigbee2MQTT has a definition for it, and ZHA has a quirk that adapts it.
Facts about this device
- Brand
- SONOFF
- Model
- MINI-ZB2GS
- Device type
- Wall switches
- Radio
- Zigbee
- Power
- Mains powered
- Reports itself as
- MINI-ZB2GS
- Zigbee2MQTT
- Device page on zigbee2mqtt.io
How the device gets into Home Assistant
- official ZHA – with a Zigbee coordinator and the ZHA integration; the quirk the device needs is part of ZHA.
- add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT.
Known problems and fixes
Changes proposed for ZHA
- pull request This pull request would allow the SONOFF MINI-ZB2GS to trigger automations based on single click, double click, long press, and follow-on/off actions of its button, which are not supported by ZHA currently.
- pull request A proposed change would replace the 'Opening' sensor in Sonoff ZBMINIR2 and MINI-ZB2GS devices with a more reliable automation trigger for better integration.
ZHA quirks for this device
Quirk included in ZHA Recommended quirk
Part of ZHA – Home Assistant uses it on its own, nothing to install.
Adds: External trigger mode Detach relay Turbo mode Network LED
Source:
zha-device-handlers · since zha-quirks 2.2.2
Signature: SONOFF / MINI-ZB2GS
2 more quirks for this device
-
Quirk proposed, not merged yet
SONOFF/MINI-ZB2GSzha-device-handlers · pull request #5651 · by @z-qj · November 3, 2026 -
Quirk proposed, not merged yet
SONOFF/MINI-ZB2GSzha-device-handlers · pull request #4903 · by @uschindler · April 5, 2026
Alternatives
The same job from other makers – devices of the same type and radio that work with Home Assistant too.
-
Tuya TS0001_switch_module Wall switches · Zigbee · 1 gang switch module Zigbee2MQTT Custom quirk needed 3 open reports Review
-
Aqara SSM-U01 Wall switches · Zigbee · Single switch module T1 (with neutral) Zigbee2MQTT ZHA quirk 2 open reports Review · from 25.50 €
-
AduroSmart 81849
Wall switches · Zigbee · ERIA Built-in Dimmer
Zigbee2MQTT
Review
-
BTicino 3584C
Wall switches · Zigbee · Connected lighting micromodule
Zigbee2MQTT
Review
Sources: Zigbee2MQTT, ZHA quirks, Z-Wave JS, the Matter certification database, Shelly, ESPHome, Tasmota, Tuya Local and the issue trackers on GitHub. Reports are assigned to a device by the identifiers they contain; the sentences come from the integration pages, where a language model writes them from the titles.
