Back to all devices

SONOFF MINI-ZB1GSP in Home Assistant

Wall switches · Zigbee · Zigbee smart switch with power monitoring

Zigbee2MQTT Quirk proposed, not merged yet 1 open report

Zigbee device – see the note above on what ZHA needs for it.

Brand: SONOFF
Model: MINI-ZB1GSP
Device type: Wall switches
Radio: Zigbee
Power: Mains powered
Reports itself as: MINI-ZB1GSP
Zigbee2MQTT: Device page on zigbee2mqtt.io

How the device gets into Home Assistant

official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above. Integration
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Integration · Source

Known problems and fixes

Requests for ZHA support

support requested The SONOFF MINI-ZB1GSP is not yet supported by ZHA. Adding support would allow Home Assistant to interact with this device. since July 27, 2026 · zha-device-handlers #5208

Changes proposed for ZHA

pull request SONOFF MINI-ZB1GSP, MINI-ZB1GS, and MINI-ZB1GP switches would not be usable, but this change would add support for turning them on and off. since July 20, 2026 · zha-device-handlers #5186
pull request The SONOFF MINI-ZB1GP and MINI-ZB1GSP devices would be added to Home Assistant, enabling control of their functions through the platform. since July 6, 2026 · zha-device-handlers #5155

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Adds: Power Current Voltage Energy today Energy this month Export energy today Export energy this month Total energy Total export energy Daily run time +18

Source: zha-device-handlers · pull request #5155 · by @040medien · July 6, 2026 · 9 approvals
Signature: SONOFF / MINI-ZB1GSP

The quirk is not part of ZHA yet. You can use it as a custom quirk until it is:

Tell ZHA where custom quirks are kept – in configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Create that folder and save the quirk as a .py file in it.
Restart Home Assistant. If the device was paired before, reconfigure it or remove and pair it again so the quirk is applied.
Check it worked: the device page shows the quirk under Zigbee info.

A custom quirk has not been reviewed by the ZHA maintainers. Delete the file once the quirk is part of a Home Assistant release – otherwise the old copy takes precedence.

All quirks in the ZHA quirk database →

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 1 open report Review
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.