How to Connect Sonoff Zigbee Devices with Zigbee2MQTT

Which Sonoff Zigbee Devices Work with Zigbee2MQTT

Sonoff makes both Wi-Fi and Zigbee devices. The Zigbee line is identifiable by "ZB" in the model name. Here's what's supported:

• ZBMINI / ZBMINI-L2: In-wall Zigbee switch (no neutral wire required for L2)
• BASICZBR3: Zigbee smart relay
• SNZB-01 / SNZB-01P: Wireless button
• SNZB-02 / SNZB-02D: Temperature and humidity sensor
• SNZB-03 / SNZB-03P: Motion sensor (PIR)
• SNZB-04: Door/window sensor
• SNZB-06P: Presence sensor (mmWave)
• S26R2ZB: Zigbee smart plug

All of these appear in the Zigbee2MQTT supported devices list and work without any Sonoff account.

Pairing Process

1. Open the Zigbee2MQTT web UI (accessible via HA sidebar if using the add-on)
2. Click Permit join (All) — the timer counts down from 254 seconds
3. Put your Sonoff device in pairing mode:
   • ZBMINI/BASICZBR3: Hold the button for 5 seconds until the LED flashes rapidly
   • SNZB sensors: Hold the reset button until the LED flashes 3 times
   • S26R2ZB plug: Hold the button for 5 seconds
4. The device appears in the Z2M device list within 30 seconds
5. Click the device → rename it (e.g., "Kitchen Light Switch")
6. Disable Permit Join after pairing

HA auto-discovers the new entities via MQTT autodiscovery within ~60 seconds of pairing.

Entity Setup in HA

After pairing a ZBMINI switch, you'll get:

• switch.kitchen_light_switch — on/off control
• sensor.kitchen_light_switch_linkquality — Zigbee signal strength

After pairing an SNZB-02D temperature/humidity sensor:

• sensor.bedroom_sensor_temperature
• sensor.bedroom_sensor_humidity
• sensor.bedroom_sensor_battery
• sensor.bedroom_sensor_linkquality

Switch Automation (YAML)

Use the SNZB-01 button to toggle a light, with different actions for single press, double press, and hold:

automation:
  - alias: "Hallway button - single press"
    trigger:
      - platform: device
        domain: mqtt
        device_id: your_snzb01_device_id
        type: action
        subtype: single
    action:
      - service: light.toggle
        target:
          entity_id: light.hallway

  - alias: "Hallway button - double press - all lights off"
    trigger:
      - platform: device
        domain: mqtt
        device_id: your_snzb01_device_id
        type: action
        subtype: double
    action:
      - service: light.turn_off
        target:
          entity_id: all

  - alias: "Hallway button - hold - dim light"
    trigger:
      - platform: device
        domain: mqtt
        device_id: your_snzb01_device_id
        type: action
        subtype: hold
    action:
      - service: light.turn_on
        target:
          entity_id: light.hallway
        data:
          brightness_pct: 20

Troubleshooting

• ZBMINI won't pair: Some early ZBMINI firmware uses a different pairing sequence. Try holding 5 seconds, then releasing, then immediately pressing again. Some users report needing 3 attempts.
• ZBMINI-L2 trips breaker or doesn't work: The L2 requires no neutral wire but draws tiny current through the load. This can cause issues with LED drivers. Add a bypass capacitor module or ensure you have at least a 1W minimum load.
• SNZB sensor drops off after a few days: Usually low battery or poor Zigbee mesh. Ensure at least one mains-powered Zigbee device (like an S26R2ZB plug) is between the sensor and the coordinator.
• Device shows up as unknown model: Update Zigbee2MQTT to the latest version — newer Sonoff devices are regularly added to the database.

FAQ

SmartWired uses affiliate links. If you buy through our links, we may earn a commission at no extra cost to you. See our Affiliate Disclosure.