Pet Infrastructure › Triage › TB-LR4-005

TB-LR4-005 App Fix · Technical Support Team · June 2026 · Read time: 4 min

Litter-Robot 4: app shows wrong status or is stuck offline

What you're seeing right now

Verify your unit's main light bar before diagnosing app status errors:

Main Light Bar Status: If the horizontal main light bar is solid red or flashing yellow, the robot is displaying an operational status (e.g., Cat Detected, Cycle Paused, or Bonnet Removed) — these are not Wi-Fi connection faults.
Connect LED Status: The Wi-Fi connection status is indicated exclusively by the small LED adjacent to the Connect button (the Connect LED). If this small Connect LED is blinking yellow or blue, the unit is in onboarding or reconnecting mode. Refer to TB-LR4-004 to resolve local Wi-Fi connection faults first.

Device Litter-Robot 4

Urgency High

Time needed 10 minutes

What to do App Cache & Reboot

In this guide

01 Why the app and the unit fall out of sync
02 Step-by-step fix checklist
03 Sourcing and replacement options
04 Advanced network settings
05 Frequently Asked Questions

💡 Quick Resolution Summary (BLUF)

Cloud-Relay Delay: The Whisker app does not communicate with the Litter-Robot 4 directly; it queries the Whisker AWS IoT cloud server. Stale statuses or "offline" states are caused by a synchronization mismatch between the unit's firmware and the cloud database, often triggered by transient Wi-Fi drops.
Top-Access Battery: Performing a true hard reset requires disconnecting both main power and the optional backup battery. The Litter-Robot 4 backup battery is accessed from the top (by removing the bonnet and globe), not from a panel underneath the base.
15-Second Hard Reset: A 15-second power down is sufficient to fully drain the motherboard's capacitors and restart the ESP32 network controller.

Litter-Robot 4 status indicators

LED Component	Light Pattern	System Meaning	Diagnostic Context
Connect LED (Small LED next to Connect button)	Blinking Yellow	Onboarding/Pairing Mode	Unit is actively broadcasting its Bluetooth pairing signal. Ready to connect to the app.
	Blinking Blue	Wi-Fi Connecting	Unit has received credentials and is attempting to obtain an IP address from the router.
	Solid Blue	Wi-Fi Connected	Successful connection. The unit is actively communicating with the Whisker API.
Main Light Bar (Main horizontal bar on bezel)	Solid Blue	Ready Standby	Unit is functional and ready for use. Remains solid blue during Wi-Fi setup.
	Flashing Blue	Waste Drawer Full	The OmniSense laser sensors detect a full waste drawer. Automatic cycling is disabled.
	Solid Red	Cat Detected	Curtain/weight sensors triggered. Unit is waiting to begin clean cycle.

01 — Why the app and the unit fall out of sync

The Litter-Robot 4 relies on a secure cloud-relay system. When the unit completes a cycle, measures weight, or changes state, it transmits this data to Whisker's cloud servers over an outbound HTTPS connection. The Whisker mobile application then pulls this data from the cloud database to refresh the dashboard.

Problem 01

Cloud-relay sequence mismatch

A brief local Wi-Fi drop — often lasting only a fraction of a second — can break the unit's session synchronization with the Whisker cloud. When the local Wi-Fi link restores, the robot attempts to send data packets. However, if the cloud server has already closed the previous secure socket, it may reject incoming packets due to session expiration.

This creates a state of stale cloud sync: the physical robot continues to cycle normally and displays a solid blue "Ready" light bar, but the Whisker cloud database retains the robot's last known status (e.g., stuck showing "Cat Detected" or "Offline"). A hard reset of the robot is required to force both sides to negotiate a fresh connection handshake.

[Litter-Robot 4]
       │
       ▼ (Outbound HTTPS 443/8443)
[Whisker Cloud API]
       │
       ▼
[Whisker Mobile App]

Problem 02

Concurrent app polling & rate limiting

If multiple household members open or refresh the Whisker application at the same time on different devices, the cloud API receives multiple concurrent state requests. To prevent resource exhaustion, Whisker's servers temporarily enforce a rate-limiting lock on the robot's specific database entry.

During this lock window, the app on all devices will display the robot as "Offline" or freeze its status. Fully closing the app on all secondary devices clears the rate-limiting block.

Follow these step-by-step instructions to perform a hard reset and clear local cache files to re-establish synchronization.

02 — Step-by-Step Fix Checklist

Perform the tasks below in order. Make sure your Wi-Fi is working and the unit's light bar is solid blue before starting. If the light bar is yellow or red, the issue is Wi-Fi connectivity — see TB-LR4-004 for the Wi-Fi fix first.

Your progress 0%

Part A — Clear the app

Close the Whisker app on all devices

Fully close and force-stop the Whisker app on every mobile device (phones and tablets) in your household. On iOS, swipe up from the bottom of the screen and swipe the Whisker app window off the top. On Android, open Recent Apps and swipe the app away, or go to Settings → Apps → Whisker and tap Force Stop.

Unplug power and disconnect the backup battery

Unplug the power barrel jack from the back of the Litter-Robot 4 base. If your unit is equipped with the optional backup battery, you must disconnect it to fully power down the logic board. To access the backup battery: press the latches on both sides of the bonnet, tilt the bonnet backward and lift it off, remove the globe by its handle, and use a Phillips screwdriver to remove the four screws securing the motor cover on the right side of the base. Gently lift the motor cover to reveal the battery compartment, and disconnect the battery terminals.

Wait 15 seconds

Leave the unit completely unpowered for at least 15 seconds. This is the official hard reset wait time prescribed by Whisker to allow residual voltage to drain from the logic board capacitors, forcing the ESP32 network controller to restart and clear any hung session states.

Litter-Robot 4 Liners & Microfiber Bundle

Official waste drawer liners and premium cleaning accessories for the Litter-Robot 4 — keeps the unit running cleanly between maintenance sessions.

Check price for Liners & Microfiber Bundle →

Part B — Restart and reconnect

Clear the Whisker app cache and log back in

While the unit remains powered down, open the Whisker app on your primary device, log out of your account, and close the app. On Android, go to Settings → Apps → Whisker → Storage and select Clear Cache (do not select Clear Data). On iOS, clearing the cache requires deleting and reinstalling the app. Once completed, relaunch the app and log back into your Whisker account.

Restore power and wait for the solid blue Ready state

Reconnect the backup battery terminals and secure the motor cover, then reassemble the globe and bonnet. Plug the main power cable back into the base of the unit. The robot will run through an initialization cycle. Wait for the main horizontal light bar to settle on a steady, solid blue. This indicates the unit is operational (Ready). The small Connect LED next to the button will also turn solid blue when the Wi-Fi connection is active.

Open the Whisker app

Launch the Whisker app on your primary device. The application will pull a fresh status report from the cloud database, which has synchronized with the rebooted robot. The status should reflect the robot's real-time state. You may now safely reopen the app on other household devices.

If the synchronization link remains broken, the internal network hardware may be faulty.

03 — Sourcing and replacement options

If the app status continues to freeze or remains stuck offline after completing the steps above, the physical Wi-Fi and network module on the unit's main circuit board has likely suffered component degradation. Because this board is integrated into the sealed motherboard casing, it cannot be replaced as an individual service part.

If your unit is under warranty, contact Whisker support for a motherboard or base assembly replacement. If out of warranty, you can replace the base assembly or upgrade to the complete Litter-Robot 4 bundle to restore all smart app features.

Litter-Robot 4 (Complete Bundle)

Upgrade to the latest Litter-Robot 4 with a fresh warranty, updated motor assembly, OmniSense laser sensor array, and stable Wi-Fi connectivity.

Shop for Litter-Robot 4 → Shop Liners & Microfiber Bundle →

As an Amazon Associate, Pet Infrastructure earns from qualifying purchases. We may receive a commission when you buy through our links, at no extra cost to you.

For advanced settings, NAT session timeouts, and specific router models, refer to the technical reference below.

04 — Advanced network settings

Use these configurations for business-grade routers or managed home networks where app sync drops persist.

App drops offline after 5–15 minutes on a managed router →

NAT Session Timeout (General Best Practice): The Litter-Robot 4 maintains a secure outbound connection to the Whisker API servers over HTTPS TCP ports **443** and **8443**. Some routers with aggressive security profiles or NAT configurations close NAT mappings for inactive connections.

Because the Litter-Robot 4 only transmits status updates periodically, the router may classify the HTTPS session as idle and close the NAT mapping. When the robot attempts to transmit a cycle completion or weight event later, the connection is blocked, causing the unit to fall out of sync.

Log into your router's admin panel, locate the firewall advanced settings, and increase the **TCP idle timeout** (or **NAT session timeout**) to at least **1200 seconds (20 minutes)** for your IoT subnet. Also ensure that outbound traffic on ports **443** and **8443** is whitelisted for the robot's IP address.

Router has deep packet inspection or intrusion prevention enabled →

DPI / IPS Whitelisting (General Best Practice): Routers featuring Deep Packet Inspection (DPI) or Intrusion Prevention Systems (IPS)—such as Ubiquiti UniFi, Firewalla, or Synology routers—can occasionally flag the Litter-Robot 4's encrypted HTTPS stream. Because the ESP32 micro-controller transmits brief, encrypted packet bursts, security engines can misclassify the traffic as anomalous.

Add the Litter-Robot 4's IP or MAC address to the DPI/IPS bypass whitelist in your security controller.

Note: The Litter-Robot 4's MAC address is not physically printed on the unit's base (the rear QR code contains only the serial number). Whisker's app does not display it. To find your unit's MAC address, check your wireless router's DHCP client reservation table or use a network scanner application (like Fing) on your phone while the robot is connected.

On a multi-WAN or load-balanced internet connection →

Policy-Based Routing (General Best Practice): If your home utilizes a multi-WAN router with dual internet connections (e.g., fiber primary with a 5G cellular or Starlink backup) configured for active load balancing, the router may dynamically route the robot's outbound traffic across different internet paths.

When the outbound public IP changes mid-session, the Whisker AWS API drops the connection due to security policy rules. This results in the robot dropping offline in the app.

Create a policy-based routing (PBR) rule on your router to bind the Litter-Robot 4's local IP address to your primary WAN connection only, preventing dynamic load-balancing shifts.

Frequently Asked Questions

Why does the Litter-Robot 4 app show the wrong status?

A temporary network drop or packet loss can cause the session synchronization between the unit and the Whisker cloud to break. The robot continues to operate normally, but the Whisker database does not record new state updates. A 15-second hard reset of the robot, along with clearing the mobile app's cache, restores sync.

What is the difference between the main light bar and the Connect LED?

The main light bar is the long horizontal strip above the globe opening that displays the unit's mechanical and operational state (e.g., solid blue for Ready standby, solid red for Cat Detected). The Connect LED is the tiny light located directly adjacent to the Connect button on the control panel, which displays network and Wi-Fi link status (e.g., solid blue for Wi-Fi connected, white for Wi-Fi disabled).

Does the Litter-Robot 4 have a backup battery, and how do I access it?

Yes, some Litter-Robot 4 units are equipped with an optional backup battery to ensure operation during power outages. Unlike the Feeder-Robot (which is accessed from the underside of the base), the Litter-Robot 4 backup battery is accessed from the top. To disconnect it, you must open the bonnet, lift out the globe, and unscrew the motor cover on the base using a Phillips screwdriver.

Why does the Litter-Robot 4 show "Offline" in the app when the light is solid blue?

A solid blue main light bar only indicates the unit is mechanically operational and ready for use. It does not guarantee active cloud synchronization. The robot may be disconnected from the Whisker cloud API due to an expired session or router session timeout, while still displaying a solid blue Ready light bar.

Based on official manufacturer documentation and practical engineering recommendations. Verified support resources can be found at the Whisker™ official diagnostic light codes troubleshooter and the Whisker™ Wi-Fi connection troubleshooting guide. Last revised: June 2026.

Need help with other smart pet gear? Check our diagnostic guides for Litter-Robot 4 cat sensor faults or Litter-Robot 4 Wi-Fi setup fixes.

Written by the Pet Infrastructure Technical Support Team Verified expert hardware repairs for pet tech devices

Related guides

TB-LR4-001