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 a properly configured MQTT broker

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

• A computer or mobile device connected to the same local 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 currently in Zigbee mode, you must switch it manually.

For firmware below 1.7.0:

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 later reverted to Wi-Fi mode.

For firmware 1.7.0 and above:

Firmware switching can only be done via the local web interface:

Settings → Switch to Matter/Zigbee

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 can now use the device in automations, scenes, or manual controls within 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.

⚠️ 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 access point.

• Connect to it and open 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 improvements.

4. Confirm Zigbee Connection Status

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

Troubleshooting