Adding Shelly devices to a Zigbee Network

System Requirements

Ensure you have the following components and access:

• A Zigbee coordinator (e.g., Sonoff ZBDongle, ConBee II, SkyConnect) connected to your smart home system

• Installed and operational Zigbee controller software, such as:

  • Home Assistant with ZHA integration, or

  • Zigbee2MQTT with the appropriate MQTT broker

• A Shelly device with Zigbee support and physical access to its button

• A computer or mobile device connected to the same network as your smart home platform

Step-by-Step Setup

Step 1: Switch to Zigbee Firmware (If Applicable)

Some Shelly devices are shipped with Wi-Fi/Matter firmware by default. If your device supports Zigbee but is not in Zigbee mode, you’ll need to switch manually:

1. Quickly press the device button 5 times.

2. Wait 5–10 seconds while the device switches to Zigbee firmware mode.

Note: This process is only required once unless the firmware is manually reverted to Wi-Fi mode later.

Step 2: Enter Pairing Mode

The Shelly device must be in pairing mode to connect to your Zigbee network.

• Automatic pairing mode: Triggered after a factory reset

• Manual pairing mode: Quickly press the button 3 times

Step 3: Pair the Device with Your Zigbee Network

For Home Assistant (ZHA)

1. Navigate to:
   Settings → Devices & Services → Add Integration → Add Zigbee Device

2. Click Add Device

3. Wait for the Shelly device to appear

4. Select it and optionally assign a name and area

For Zigbee2MQTT

1. Open the Zigbee2MQTT web interface (typically http://<your-ip>:8080)

2. Click Permit Join

3. Wait for the Shelly device to be discovered

4. Rename and configure it as needed

Step 4: Begin Using the Device

After successful pairing, the device will expose its available Zigbee entities, such as:

• Switches

• Sensors

• Battery level indicators (if supported)

You may now use the device in automations, scenes, or manual control via your Zigbee platform.

Step 5 (Recommended): Update Zigbee Firmware

For optimal performance and continued compatibility, update your Shelly device to the latest Zigbee firmware version.

⚠️ Note: Firmware updates must currently be performed in Wi-Fi/BLE mode. Zigbee OTA updates are not supported at this time.

Update Procedure

1. Enable Wi-Fi/BLE Mode
   Press and hold the button on the back for 5 seconds to switch modes.

2. Connect to the Device's Access Point

   • After reset, the device broadcasts a local Wi-Fi AP.

   • Connect to it, then access http://192.168.33.1 in your browser.

3. Update Firmware via Web Interface

   • Go to Settings → Firmware

   • Install the latest available firmware version that includes Zigbee enhancements

4. Confirm Zigbee Connection Info

If the status shows “failed”, press the button 3 times quickly to re-enter pairing mode.

Troubleshooting