SONOFF Troubleshooting Guides

Find solutions for all your SONOFF smart home device issues. Browse 30 troubleshooting guides across 2 device categories.

Visit SONOFF Official Site

Browse by Device Type

Select a category to find SONOFF troubleshooting guides

All SONOFF Troubleshooting Guides (30)

How to Fix Sonoff Device Offline in eWeLink

Smart Switches • Sonoff eWeLink Offline

A Sonoff device appears offline in eWeLink and cannot be controlled remotely. This often follows router changes, weak 2.4GHz conditions, overloaded APs, MAC filtering, or pairing done from the wrong network context.

easy 10-15 minutes 183 views

Why Do Sonoff Zigbee Devices Keep Dropping From Network?

Smart Sensors • Sonoff Zigbee Stability

Sonoff Zigbee sensors repeatedly drop from the network, causing missing automations and stale status. This often comes from weak mesh routing, poor repeater quality, coordinator firmware issues, or battery and interference conditions.

medium 20-30 minutes 119 views

How to Fix Sonoff Zigbee Device Not Joining Bridge After Reset

Smart Switches • Sonoff Zigbee Join Failures

You factory reset a SONOFF Zigbee device (SNZB-01, SNZB-02, SNZB-03, SNZB-04, or ZBMINI) and it will not rejoin the SONOFF Zigbee Bridge or Zigbee Bridge Pro. The bridge may not be in pairing mode, the device may still be bound to a previous coordinator, or the bridge may have reached its device limit (32 on the original ZBBridge, 128 on the ZBBridge-P).

medium 10-15 minutes 85 views

How to Fix Sonoff Device Online but Not Responding in App

Smart Switches • Sonoff Command Sync

The Sonoff device appears online in eWeLink but command attempts fail or do not change physical state. This mismatch typically indicates cloud-command timeout, stale app session, firmware command queue issues, or router path instability.

medium 10-20 minutes 82 views

How to Fix Sonoff Device Fails Firmware Update in eWeLink

Smart Switches • Sonoff Firmware Updates

Your SONOFF device shows a firmware update available in eWeLink, but the update fails partway through — the progress bar stalls, the app shows an error, or the device reboots without completing the update. This happens most often with the BASICR4, MINIR4, and TH Elite models when WiFi signal is weak or the app loses its connection during the download. A failed firmware update can leave the device unresponsive if it was interrupted during the flash write.

medium 15-20 minutes 77 views

How to Fix Sonoff Smart Switch Not Updating Firmware

Smart Switches • Sonoff Firmware Update Failures

Your SONOFF smart switch shows a firmware update available in eWeLink, but the update fails or never completes. The progress bar may stall, the app may show an error message, or the device may reboot without applying the new firmware. Firmware updates require a stable WiFi connection and continuous power throughout the 1-4 minute process.

medium 15-20 minutes 68 views

Why Does Sonoff Device Keep Going Offline at Night?

Smart Switches • Sonoff Nighttime Dropouts

Your SONOFF device goes offline in eWeLink every night around the same time and comes back online in the morning. The device works fine during the day but consistently drops off at night. Common causes include router WiFi power-saving schedules that shut off the radio overnight, DHCP leases expiring while the device is idle, the circuit being on a switch or timer someone turns off at night, or a firmware bug that stops sending keepalive packets after extended idle periods.

medium 15-20 minutes 67 views

How to Fix Sonoff Device Unreachable on Local LAN Control

Smart Switches • Sonoff Local Reachability

You enabled LAN control in eWeLink but your SONOFF device is still unreachable over the local network. The app falls back to cloud control or shows the device as unavailable. LAN mode uses mDNS discovery to find devices on your local network — it fails when devices are on different subnets, when your router blocks multicast traffic, or when AP isolation is enabled.

medium 15-20 minutes 60 views

How to Fix Sonoff MINIR4 Losing Pairing After Firmware Update

Smart Switches • Sonoff MINIR4 Pairing Loss

Your SONOFF MINIR4 was working fine, but after installing a firmware update it lost its WiFi configuration and entered pairing mode (LED blinking rapidly). The firmware updated successfully, but the WiFi credentials stored in flash memory were cleared during the process. You need to re-pair the device in eWeLink and reconfigure settings like Power-On State, external switch type, and third-party integrations.

medium 15-20 minutes 60 views

How to Fix Sonoff Pairing Succeeds but Device Stays Offline

Smart Switches • Sonoff Onboarding Drift

You paired a SONOFF device in eWeLink and the app says pairing was successful, but the device immediately shows as offline. The pairing process registers the device on SONOFF's cloud, but the device itself failed to connect to your WiFi router. Common causes: incorrect WiFi password, router using WPA3 or 5GHz only, MAC address filtering blocking the device, or the DHCP pool being full.

easy 10-15 minutes 56 views

How to Fix Sonoff Device Name Changes Not Syncing Across Apps

Smart Switches • Sonoff Metadata Sync

You renamed a SONOFF device in the eWeLink app, but the old name still appears in Alexa, Google Home, or Home Assistant. Or you renamed it in Alexa but eWeLink still shows the original name. Device names are stored separately in each platform — renaming in one does not automatically propagate to others. This affects voice commands because Alexa and Google respond to the name stored in their own system, not the eWeLink name.

easy 10-15 minutes 55 views

How to Fix Sonoff Switch Schedule Not Running at Set Time

Smart Switches • Sonoff Schedule Timing Errors

Your SONOFF switch schedule is set in eWeLink to turn on at a specific time, but it fires early, late, or not at all. The most common cause is a wrong time zone in the eWeLink app settings. Other causes include cloud-based schedules failing when the device is temporarily offline, one-time schedules that auto-disable after firing, or conflicting automations from other platforms overriding the schedule.

medium 10-15 minutes 53 views

How to Fix Sonoff Switch Commands Timing Out in App

Smart Switches • Sonoff Command Timeout

Your SONOFF switch shows 'Command timed out' or 'Device not responding' when you try to toggle it in eWeLink. The switch may or may not actually respond to the command — sometimes the relay clicks but the app does not receive confirmation. This can affect one switch or all switches simultaneously, depending on whether the cause is local (WiFi signal) or cloud-side (SONOFF server issues).

medium 10-15 minutes 50 views

How to Fix Sonoff Device Stuck Offline After Power Outage

Smart Switches • Sonoff Post-Outage Recovery

Your SONOFF device went offline during a power outage and did not come back online when power returned. The eWeLink app shows the device as offline (grey icon). The LED on the device may be blinking rapidly (indicating it entered pairing mode) or solid but the cloud connection was not re-established. This is common with older SONOFF models that do not retry WiFi connections aggressively after boot.

easy 10-15 minutes 49 views

Why Is Sonoff Temperature Sensor Reporting Inaccurate Values?

Smart Sensors • Sonoff Sensor Accuracy

Your SONOFF SNZB-02 temperature sensor reports readings that are 2-5°C off from the actual room temperature. The sensor may read consistently high (common when mounted near a window or heat source), consistently low, or show stale readings that do not update for long periods. The SNZB-02 has ±0.3°C accuracy under ideal conditions, but placement, battery health, and reporting intervals all affect real-world performance.

medium 10-15 minutes 47 views

How to Fix Sonoff Switch State Desync in eWeLink

Smart Switches • Sonoff State Sync

The eWeLink app displays the wrong on/off state for your SONOFF switch. The app says the switch is ON when it is actually OFF, or vice versa. This state mismatch causes confusion and can trigger incorrect automations. Common causes include stale app cache, incorrect external switch type configuration on in-wall models, and conflicting automations from multiple platforms sending opposing commands.

medium 10-15 minutes 35 views

How to Fix Sonoff Device Shows Offline Only on One Phone

Smart Switches • Sonoff Client-Specific Offline

Your SONOFF device appears online and controllable on one phone but shows offline on another. Both phones have the eWeLink app installed. The issue is usually a stale app cache on the affected phone, different eWeLink accounts or server regions, an outdated app version, or the phone being on a restricted network that cannot reach SONOFF's cloud servers.

easy 10-15 minutes 33 views

How to Fix Sonoff Device Reconnect Storm After Router Update

Smart Switches • Sonoff Post-Update Reconnect Storm

After updating your router firmware or changing WiFi settings, all your SONOFF devices went offline at once and are struggling to reconnect. Some come back after minutes, others stay offline for 30+ minutes, and a few may never reconnect without manual intervention. When 10-30 WiFi devices all try to associate simultaneously, they overwhelm the router's connection queue and create a cascade of failed attempts.

medium 15-20 minutes 32 views

How to Fix Sonoff Device Command Delays in eWeLink App

Smart Switches • Sonoff Command Latency

Your SONOFF switch takes 2-5 seconds to respond after tapping on/off in the eWeLink app. The relay clicks late or sometimes the app shows a timeout error. Commands sent through Alexa or Google Home also feel sluggish. This delay happens because eWeLink routes commands through SONOFF's cloud servers by default, adding network round-trip latency on top of any local WiFi issues at the device.

easy 10-15 minutes 31 views

How to Fix Sonoff Device Not Rejoining After Power Loss

Smart Switches • Sonoff Post-Outage Recovery

After a power outage, your SONOFF device does not come back online in eWeLink. The LED may be blinking rapidly (pairing mode triggered by power flicker), or the device boots before your router is ready and gives up trying to connect. Older models like the BASICR2 are especially prone to this because they do not retry WiFi connections indefinitely after a failed attempt.

medium 15-20 minutes 31 views

Why Is Sonoff Door Sensor Reporting Late or Wrong State?

Smart Sensors • Sonoff Door Sensor Reliability

Your SONOFF SNZB-04 door sensor reports the wrong state (shows open when the door is closed, or vice versa) or reports the correct state but with a 5-30 second delay. A stuck or worn reed switch, incorrect magnet installation orientation, weak Zigbee mesh routing, or a low battery causing unreliable radio transmissions are the most common causes.

medium 15-20 minutes 31 views

How to Fix Sonoff Zigbee Motion Sensor Delays

Smart Sensors • Sonoff Motion Sensor Latency

Your SONOFF SNZB-03 motion sensor detects movement but the event arrives in eWeLink or Home Assistant with a noticeable delay — 1-5 seconds after you walk past it. Or the sensor misses motion events entirely when you walk through the zone shortly after a previous detection. The SNZB-03 has a built-in 60-second cooldown period after each detection, and Zigbee mesh routing adds additional latency.

medium 15-20 minutes 30 views

How to Fix Sonoff Device Not Appearing in Shared Home

Smart Switches • Sonoff Shared Home Visibility

You shared your SONOFF device or Home in eWeLink with a family member, but they cannot see the device in their app. The invitation may be pending, the accounts may be on different server regions (Americas vs. Europe), or the device was added before the Home was created and is not assigned to the shared Home. Shared users with 'Guest' permissions can also see devices but not control them.

easy 10-15 minutes 28 views

Why Is Sonoff Water Leak Sensor Triggering False Alerts?

Smart Sensors • Sonoff False Leak Alerts

Your SONOFF SNZB-05 water leak sensor triggers a leak alert when there is no water present. The sensor detects water by measuring electrical conductivity between two metal probes on its bottom surface. False alerts happen when the probes are dirty with mineral deposits, the sensor sits on a damp or conductive surface, condensation forms underneath from cold pipes, or the battery is low enough to cause erratic ADC readings.

medium 10-15 minutes 25 views

How to Fix Sonoff Device Failing to Sync State After App Control

Smart Switches • Sonoff App-State Sync

The eWeLink app shows your SONOFF device as ON, but the actual device and connected appliance are OFF — or the reverse. The state displayed in the app does not match the physical relay position. This happens when a state change event gets lost between the device and the cloud, when the app cache is stale, or when multiple control sources (eWeLink, Alexa, Home Assistant) send conflicting commands.

medium 10-15 minutes 24 views

Why Is Sonoff Contact Sensor Missing Open Events?

Smart Sensors • Sonoff Contact Event Loss

Your SONOFF SNZB-04 contact sensor occasionally misses door or window open events — the door opens but eWeLink or Home Assistant does not register the state change. The sensor uses a reed switch that detects the companion magnet. Missed events trace to the magnet gap being too wide, slow door movement, weak Zigbee mesh routing dropping packets, or a dying CR2032 battery reducing transmission reliability.

medium 15-20 minutes 24 views

Why Is Sonoff Door Sensor Showing Frequent Open-Close Flapping?

Smart Sensors • Sonoff Contact Sensor Flapping

Your SONOFF SNZB-04 contact sensor rapidly alternates between open and closed states — sometimes dozens of times per minute — even when the door is not moving. This 'flapping' triggers repeated automation runs, fills up event logs, and drains the battery. It happens when the magnet sits right at the reed switch activation threshold, where tiny vibrations cause the contacts to bounce.

easy 10-15 minutes 24 views

Why Is Sonoff Motion Sensor Missing Nighttime Motion Events?

Smart Sensors • Sonoff Night Motion Gaps

Your SONOFF SNZB-03 motion sensor works reliably during the day but misses motion events at night — lights do not turn on when you walk through a room, or automations do not fire. PIR sensors detect heat differential against the ambient temperature, so warm rooms at night reduce sensitivity. The 60-second cooldown period also causes missed events when you walk through a zone shortly after a previous detection.

easy 10-15 minutes 24 views

Why Is Sonoff Motion Sensor Triggering False Events?

Smart Sensors • Sonoff False Motion Alerts

Your SONOFF SNZB-03 motion sensor triggers when no one is in the room — lights turn on by themselves, phantom motion events appear in the log. PIR sensors detect changes in infrared radiation, so HVAC vents, sunlight beams through blinds, pet movement, and car headlights through windows all create heat signatures that trigger false detections.

medium 15-20 minutes 23 views

Why Is Sonoff Zigbee Sensor Battery Draining Fast?

Smart Sensors • Sonoff Sensor Battery Drain

Your SONOFF Zigbee sensor battery is draining in weeks or a few months instead of the expected 12-18 months. The CR2450 (SNZB-02, SNZB-03) or CR2032 (SNZB-04) battery runs out far too quickly. Excessive event transmission frequency, Zigbee routing problems causing retransmissions, short reporting intervals, cheap batteries, or a firmware bug that sends check-ins every 30 seconds instead of every 60 minutes are the most common causes.

medium 15-20 minutes 23 views