Troubleshooting guide
Zigbee2MQTT Device Offline After Pairing: Diagnose the Drop-Off
Category: Smart Home
You paired a new Zigbee device with your USB coordinator, it joined successfully, but after a short time it stops reporting state and appears as a zigbee2mqtt device offline in the interface.
Confirm the Device Is Actually Offline
Open the device in the Zigbee2MQTT frontend and check the last seen timestamp. If it has not updated in more than 10 minutes, the device is not reporting. Also check the coordinator’s link quality indicator for that device. A value below 20 suggests a weak or unstable connection. If the device shows as online but state is stale, the issue is reporting, not pairing.
Check Power and Reporting Configuration
Battery-powered devices often sleep to save energy. Verify the battery is fresh and correctly inserted. For mains-powered devices, confirm the power source is stable. Next, check the device’s reporting interval in the expose tab. If the minimum report interval is set too high, the device may appear offline between reports. Set it to a reasonable value, such as 60 seconds, and press the device’s physical button to wake it.
Run a Verification Test
Trigger the device manually (press a button, open a door, or change state). Watch the last seen timestamp in Zigbee2MQTT. If it updates immediately, the device is communicating. If it does not, move the device closer to the coordinator and repeat. If it updates only when close, the problem is range or interference.
Rollback and Recovery
If you changed reporting settings, revert them to the previous values. If the device still drops, remove it from Zigbee2MQTT, reset the device per its manual, and pair again. Keep the device in its final location during pairing to establish the correct route.
If these steps do not restore stable reporting,

Ask for help with your logs and device model.