WhatsApp Web Not Working: QR Scans, Disconnects and Sync Failures Fixed

Four different failures get called "WhatsApp Web not working", and they have nothing in common. Find your symptom first.

Symptom 1: the QR code never appears#

The page loads but the code area stays blank or spins.

1. Hard refresh (Ctrl/Cmd + Shift + R). Stale service-worker caches are the single most common cause after an update.
2. Clear site data for web.whatsapp.com specifically, then reload.
3. Open an incognito window. If the code appears there, an extension is the culprit — ad blockers, privacy extensions and script blockers all do this.
4. Switch network. Corporate networks, school Wi-Fi and some VPNs block WhatsApp's endpoints. Tethering to a phone for thirty seconds proves it immediately.
5. Try the desktop app instead of the browser. It uses different networking and sometimes works where the browser does not.

If it works in incognito on mobile data, you have a network or extension problem — not a WhatsApp problem.

Symptom 2: the code appears but will not scan#

This is a camera problem, not a site problem.

• Raise screen brightness. Dim screens are the most common cause on laptops in power-saving mode.
• Reset browser zoom to 100%. A heavily zoomed code confuses the scanner.
• Clean the camera lens.
• Avoid direct light on the screen — glare washes out the code.
• Make sure you are scanning from Linked devices in WhatsApp, not from the phone's camera app.

Symptom 3: it connects, then logs out repeatedly#

The linked session depends on your phone remaining reachable.

• Android battery optimisation. Set WhatsApp to Unrestricted, and exclude it from any manufacturer power manager (Xiaomi, Samsung, Oppo, Vivo, OnePlus all ship one).
• Linked device limit. WhatsApp allows a limited number of linked devices; adding another beyond that drops the oldest silently. Open Linked devices in the app and remove sessions you no longer use.
• Inactivity. A linked device that goes unused for an extended period is unlinked automatically. If you use a machine once a month, expect to re-link.
• Signing out elsewhere. "Log out from all devices" in the app ends every session, including the one you are using.

If your team is re-linking constantly because several people need the same number, that is not a bug to fix — it is the wrong tool. One number across a team covers what to use instead.

Symptom 4: connected, but messages do not sync#

• Check the phone. Even with multi-device, the phone losing connectivity for a long time causes drift. Open WhatsApp on the phone and let it catch up.
• Background tab throttling. Browsers throttle inactive tabs aggressively. If new messages only appear when you focus the tab, that is what you are seeing. Keeping the tab pinned and the window unminimised helps; the desktop app avoids it entirely.
• System clock. A wrong clock on the computer breaks the secure session as surely as it does on a phone.
• Old chats missing. Multi-device sync brings recent history, not everything. Full archives live on the phone.

Browser-specific notes#

• Safari is the most restrictive on background activity and cross-site storage; if a colleague's Chrome works and your Safari does not, that is expected.
• Firefox with strict tracking protection blocks storage WhatsApp Web needs. Add an exception for the domain.
• Brave requires shields down for the site.
• Chrome profiles each hold their own session — logging in on one profile does not carry to another.

When the browser is the wrong tool#

WhatsApp Web is a mirror of one phone. That design causes three problems for businesses, none of which are fixable with a browser setting:

1. One session, many people. Sharing a login means anyone can read every conversation and nobody owns any of them.
2. The phone is a dependency. Flat battery, lost phone, staff member on leave — the whole channel stops.
3. No assignment, no notes, no reporting. You cannot tell who answered what, or how long anyone waited.

The Business Platform removes the phone from the loop entirely: conversations arrive over the API and are answered from a browser inbox with real accounts.

If your team is fighting the browser every morning, that is the signal to move. Try AR-Inbox — a shared WhatsApp inbox with assignment, internal notes and no QR code to re-scan.

Related: messages not sending · notifications not working.