Back to all devices

SONOFF MINI-ZBD in Home Assistant

Wall switches · Zigbee · Zigbee smart switch

Zigbee2MQTT Quirk included in ZHA 2 open reports

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-ZBD
Device type
Wall switches
Radio
Zigbee
Power
Mains powered
Reports itself as
SONOFF
Same device as
SONOFF ZBMINIR2
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. 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

Open problems

  • open The ZBMINIR2 sensor incorrectly reports 'closed' in ZHA, even when open. Fixing this would allow accurate detection of the sensor's state in Home Assistant. since October 2, 2025 · zha-device-handlers #4364

Requests for ZHA support

  • support requested The Sonoff ZBMINIL2 device is not supported in ZHA. Adding a quirk would let Home Assistant recognize and control this device properly. since September 10, 2025 · zha-device-handlers #4338

Changes proposed for ZHA

  • pull request The Sonoff ZBMINIR2 switch lacks support for inching, power-on delay, and action events in ZHA. This change would let you configure these settings via Home Assistant. since September 10, 2026 · zha-device-handlers #5317
  • pull request The Sonoff ZBMINIR2 motor would not allow inching control in Home Assistant. The pull request would add support for precise position adjustments. since June 30, 2026 · zha-device-handlers #5135
  • 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. since April 5, 2026 · zha-device-handlers #4903

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 Turbo mode Detach relay Network LED

Source: zha-device-handlers · since zha-quirks 2.2.2
Signature: SONOFF / ZBMINIR2

3 more quirks for this device

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.

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.

Scroll to Top