Quick answer: To fix WhatsApp not working, remove network blockers (VPN/Private DNS/proxy), allow background data/battery access, then repair app data (clear cache/storage on Android or reinstall on iPhone) and update WhatsApp.
Use the checklist below to match your symptom to the real cause (DNS filtering, background restrictions, corrupted local data, Web/Desktop session tokens, or a temporary account/device restriction) and fix it in minutes.
Quick Fix Checklist
- Stuck on “Connecting” / one tick forever: Turn off VPN → set Android Private DNS to Off/Automatic → remove Wi‑Fi proxy → try mobile data.
- Messages send but never deliver / media won’t download: Disable DNS/ad-block filtering (NextDNS/Pi-hole/AdGuard) or switch networks; then retry download.
- Notifications delayed until you open WhatsApp: Allow Background data + set battery to Unrestricted (Android) or enable Background App Refresh (iPhone).
- App won’t open / crashes instantly: Update WhatsApp + reboot; then clear cache (Android) or reinstall (iPhone). If Android still crashes, update Android System WebView.
- Calls fail / no audio: Allow microphone permission, disable firewall/ad-block apps, and turn off Low Data Mode/Data Saver while testing.
- WhatsApp Web/Desktop not syncing: Log out of all linked devices → clear web.whatsapp.com site data → re-link with a fresh QR code.
- Verification SMS/call not arriving: Confirm country code, disable spam filtering, stop repeated requests (rate limit), and retry once after waiting.
Causes (realistic, not generic)
- VPN/Proxy/Private DNS interference: Encrypted DNS, ad-block DNS, or proxies can break WhatsApp’s connection handshake or media endpoints.
- Router or network filtering: Pi-hole/NextDNS/AdGuard Home, corporate Wi‑Fi, school networks, or captive portals can block WhatsApp domains/ports.
- Background restrictions: Battery optimization, Data Saver, “Restrict background data,” or OEM task killers stop WhatsApp from keeping a live connection.
- Corrupted local app data: Cache/database corruption after updates can cause crashes, blank chats, stuck “Initializing,” or endless loading.
- Time/clock mismatch: Incorrect time breaks TLS certificate validation and can cause “Connecting” loops.
- Web/Desktop token/session issues: Stale linked-device sessions can stop syncing even when the phone works.
- Account/device temporary restriction: Too many verification attempts, unofficial clients, automation, or suspicious activity can trigger a temporary block.
- Android component conflicts: Outdated Android System WebView or Chrome can cause crashes/blank screens in apps after OS updates.
| Cause / Symptom | Fix that works |
|---|---|
| VPN/Private DNS → stuck on “Connecting” | Disable VPN, set Private DNS to Off/Automatic, force-close WhatsApp, reopen |
| Wi‑Fi DNS filtering (Pi-hole/NextDNS) → media won’t load | Switch to mobile data to confirm, then bypass/allowlist WhatsApp on the DNS filter |
| Battery/Data Saver → notifications delayed | Enable background data + set battery to Unrestricted (Android) / Background App Refresh (iPhone) |
| Corrupted cache/data → crashes, blank chats | Clear cache (Android) → if needed clear storage after backup / reinstall on iPhone |
| Permissions/firewall → calls fail | Allow mic permission + disable firewall/ad-block rules for WhatsApp |
| Stale linked session → Web/Desktop won’t sync | Log out of all linked devices, clear web site data, re-link with a new QR |
| WebView/Chrome conflict → app opens to blank screen | Update Android System WebView + Chrome, reboot, then retry |
Step-by-Step Fix
1) Identify your exact failure (30 seconds)
- Connection issue: “Connecting…” never ends, messages stuck on clock/one tick, media won’t download.
- App issue: Won’t open, freezes, crashes, chats won’t load, stuck on “Initializing.”
- Feature issue: Calls fail, camera/mic not working, notifications delayed, Web/Desktop not syncing.
- Account issue: Can’t verify number, “This account is not allowed to use WhatsApp,” repeated logouts.
2) Do the fastest isolation test (pinpoint Wi‑Fi vs phone)
This prevents wasting time on the wrong fix.
- Turn Wi‑Fi off and test on mobile data with VPN off.
- If WhatsApp works on mobile data but not Wi‑Fi, the problem is your Wi‑Fi/DNS/proxy/router filter.
- If it fails on both, focus on device/app/account steps below.
3) Remove network blockers (most common WhatsApp not working fix)
Anything that rewrites DNS or routes traffic can break WhatsApp.
- Disable VPN inside the VPN app (not just disconnecting Wi‑Fi). Then force-close WhatsApp and reopen.
- Android: turn off Private DNS
- Settings → Network & Internet → Private DNS
- Select Off or Automatic (avoid custom providers while testing)
- Remove proxies
- Wi‑Fi network → Advanced → Proxy → None
- WhatsApp → Settings → Storage and data → Proxy → Disable (if present)
- If your Wi‑Fi uses DNS filtering (Pi-hole/NextDNS/AdGuard Home):
- Confirm by switching to mobile data; if it works, your filter is blocking WhatsApp.
- Temporarily bypass the filter or allowlist WhatsApp-related traffic in your DNS/filter dashboard.
- After changes, toggle airplane mode on/off or reboot the router to flush DNS.
- Captive portal check: On public Wi‑Fi, open a browser and complete the sign-in page; WhatsApp may not connect until you do.
4) Fix background restrictions (delayed messages/notifications)
If messages arrive only when you open WhatsApp, the OS is blocking background networking.
- Android:
- Settings → Apps → WhatsApp → Mobile data & Wi‑Fi → enable Background data and Unrestricted data usage (names vary).
- Settings → Apps → WhatsApp → Battery → set to Unrestricted (or disable optimization).
- Turn off Data Saver (Settings → Network & Internet → Data Saver) while testing.
- If your phone has an OEM “battery manager” (Samsung/MIUI/ColorOS), add WhatsApp to its Never sleeping/Allowlist.
- iPhone:
- Settings → General → Background App Refresh → enable for WhatsApp.
- Settings → Cellular → WhatsApp → ensure cellular data is enabled.
- Settings → Cellular → Low Data Mode → turn off for the active line while testing.
- Settings → Focus / Do Not Disturb → ensure WhatsApp notifications are allowed if you’re missing alerts.
5) Repair corrupted app data (crash, blank chats, endless loading)
Do this when WhatsApp opens but behaves broken after an update, or crashes immediately.
- Before you wipe anything: If WhatsApp still opens, run a chat backup first (Settings → Chats → Chat backup).
- Android (safe first step): clear cache
- Settings → Apps → WhatsApp → Storage & cache → Clear cache
- Android (stronger fix): clear storage after backup
- WhatsApp → Settings → Chats → Chat backup → run a backup (Google Drive if enabled).
- Settings → Apps → WhatsApp → Storage & cache → Clear storage (logs you out and removes local data).
- Open WhatsApp → verify number → restore backup when prompted.
- iPhone: reinstall (cache clearing isn’t equivalent)
- WhatsApp → Settings → Chats → Chat Backup → Back Up Now (iCloud).
- Delete WhatsApp → restart iPhone → reinstall from the App Store → verify number → restore from iCloud.
6) Advanced: fix Android WebView/Chrome update conflicts (non-obvious but common)
If WhatsApp shows a blank screen, crashes on launch, or freezes after an Android update, WebView can be the culprit.
- Open Google Play → update Android System WebView and Google Chrome.
- Reboot the phone.
- Retry WhatsApp. If it still fails, update WhatsApp again (or join/leave beta only if you know what you’re doing).
7) Fix time/certificate issues (for “Connecting” loops)
- Android: Settings → System → Date & time → enable Set time automatically and Set time zone automatically.
- iPhone: Settings → General → Date & Time → enable Set Automatically.
8) Fix calls not working (permissions + network rules)
- Allow permissions: Settings → Apps → WhatsApp → Permissions → enable Microphone (and Camera for video calls).
- Disable local firewall/ad blockers (AdGuard/Blokada/NetGuard) and test again.
- On Wi‑Fi, try mobile data (or another Wi‑Fi). Some networks block VoIP.
- If Bluetooth audio is broken, disconnect Bluetooth and retry to rule out a headset routing issue.
9) WhatsApp Web/Desktop not working (fast reset)
- On phone: WhatsApp → Settings → Linked devices → Log out of all devices.
- On computer (browser): clear site data for web.whatsapp.com (cookies + storage), then reload.
- Re-link using a fresh QR code.
- Advanced browser fix: Try an Incognito/Private window or a new browser profile with extensions disabled (script blockers/privacy extensions often break QR linking).
- Desktop app: Fully quit the app (not just close window) and reopen; if needed, update/reinstall the Desktop app.
10) Verification/registration stuck (SMS/call not arriving)
- Confirm the country code and number format (avoid extra zeros/spaces).
- Disable spam call/SMS filtering apps and carrier call screening temporarily.
- Stop retrying repeatedly: Too many requests triggers rate limits. Wait (often 15–60 minutes, sometimes longer), then request one method once.
- If dual SIM: set the correct SIM as default for SMS/phone and ensure it can receive SMS normally.
- If you recently ported your number or changed carriers, verify you can receive standard SMS from other services first.
11) Advanced: isolate device-level firewall/MDM interference
Local VPN-based blockers and work profiles can block WhatsApp even when the internet works.
- Temporarily disable the ad blocker/firewall profile and test WhatsApp.
- If you must keep it enabled, add WhatsApp to the allowlist and disable HTTPS filtering for WhatsApp traffic.
- On managed/work phones, check for an MDM profile enforcing a VPN or content filter that blocks messaging apps.
Still Not Working
- Check if it’s an outage (fast): Ask someone on a different network to send you a message, or test WhatsApp Web on another connection. If multiple people can’t connect, it may be a service incident.
- Look for the exact error message and act on it:
- “This account is not allowed to use WhatsApp”: Use the in-app review/appeal option; remove unofficial clients, mods, or automation tools.
- “Date is inaccurate” / certificate errors: Fix automatic time/time zone, reboot, then retry.
- “Storage almost full”: Free space (WhatsApp needs working space for databases/media). Then restart WhatsApp.
- Rule out SIM/account edge cases:
- If verification fails only on one number, test the SIM in another phone to confirm SMS/calls work.
- If you changed phones recently, ensure you’re not stuck in a loop from repeated verification attempts—wait out the timer before trying again.
- Do a clean reinstall (last resort, but effective):
- Back up chats (Google Drive/iCloud) if possible.
- Uninstall WhatsApp → reboot → reinstall from the official store → verify → restore backup.
- Escalate to WhatsApp Support with useful diagnostics:
- WhatsApp → Settings → Help → Contact Us (include logs if prompted).
- Include: exact error text, when it started, WhatsApp version, OS version, network (Wi‑Fi/mobile), VPN/Private DNS status, and whether it works on mobile data.
If you want the fastest diagnosis, test in this order: mobile data (no VPN) → Wi‑Fi with Private DNS off → after cache/storage repair or reinstall. The first step that fixes it tells you the real cause.
If the App Fails but the Browser Works
If the browser version works but the app fails, the account itself is usually not the problem.
Why this happens
This pattern normally points to corrupted app cache, stale local session data, or a device-specific networking issue.
How to fix it
- Use the working browser session as a control test while troubleshooting the app.
- Force close the app and reopen it before trying the same action again.
- Disable VPN, proxy, DNS filtering, or security apps temporarily.
- Update or reinstall the app if the same failure only appears inside the app.
Important notes
- This is one of the fastest ways to narrow the issue to the app layer instead of the account layer.
- If the app still fails after reinstalling, the device configuration may be the next thing to inspect.
Frequently Asked Questions
WhatsApp stuck on “Connecting” on Wi‑Fi but works on mobile data—what’s the fix?
Your Wi‑Fi network is blocking WhatsApp (Private DNS, router DNS filtering like Pi-hole/NextDNS, proxy, or firewall). Turn off Android Private DNS, remove any Wi‑Fi proxy, and bypass/allowlist WhatsApp in your DNS filter; then force-close and reopen WhatsApp.
WhatsApp notifications are delayed until I open the app (Android)—how do I fix it?
Disable battery optimization and allow background data for WhatsApp. Go to Settings → Apps → WhatsApp → Battery → Unrestricted, and Settings → Apps → WhatsApp → Mobile data & Wi‑Fi → enable Background data/Unrestricted data usage; also turn off Data Saver while testing.
WhatsApp keeps crashing or shows a blank screen after an Android update—what should I update?
Update Android System WebView and Google Chrome from the Play Store, reboot, then update WhatsApp. WebView/Chrome conflicts commonly cause blank screens and crashes across apps after system updates.
WhatsApp Web QR code won’t scan or Desktop won’t sync—what actually fixes it?
Log out of all linked devices on your phone (Settings → Linked devices), clear site data for web.whatsapp.com (cookies/storage), then re-link. If it still fails, use a fresh browser profile or Incognito with extensions disabled to rule out script/privacy blockers.
I’m not receiving the WhatsApp verification code—how long should I wait and what should I check?
Stop repeated requests (rate limits can block new codes) and wait for the timer to expire—often 15–60 minutes, sometimes longer. Confirm the country code/number format, disable spam call/SMS filtering, ensure the correct SIM is default for SMS/phone, and request one method once.
WhatsApp calls fail but messages work—what settings block calls?
VoIP calls are commonly blocked by microphone permissions, local firewall/ad-block apps, or restrictive networks. Enable Microphone permission for WhatsApp, temporarily disable VPN/firewall/ad blockers, and test on a different network (mobile data vs Wi‑Fi).