"A database error occurred on your browser" on WhatsApp Web: how to fix it
You open WhatsApp Web, scan the code or wait for your chats to load, and get this instead: "A database error occurred on your browser." Sometimes it asks you to relink your device, and relinking brings the same message back.
The error is about your browser, not your WhatsApp account. Your chats are still on your phone. According to WhatsApp's Help Center, WhatsApp Web keeps your messages in a database inside your browser, and when something is wrong with that database, linking can fail. So the fix is to give WhatsApp Web a clean database to start over with.
Try these in order. The first two take a minute and don't touch anything else in your browser.
1. Test in an Incognito or private window
In Chrome, press Ctrl + Shift + N (Mac: ⌘ + Shift + N) and go to web.whatsapp.com. Google's Incognito help page explains that Incognito starts a separate session, with its own cookies and site data that are thrown away when you close it.
If WhatsApp Web links fine there, your account and connection are working, and the likely problem is the data stored in your normal Chrome profile. Go to step 3 to clear it. Don't keep using Incognito for WhatsApp: you'd have to link again every time you close the window.
If you get the same error in Incognito too, skip ahead to step 2 and step 5.
2. Try a different browser
This is the first fix WhatsApp itself suggests. WhatsApp Web works on the latest versions of Chrome, Firefox, Microsoft Edge, Opera and Safari, and not on older browsers like Internet Explorer, per the Help Center.
If it works in Edge or Firefox, you can keep using that while you fix Chrome, or for good.
3. Clear only WhatsApp's data in Chrome
WhatsApp's own page tells you to delete all cookies and cached files for All time. That works, but it also signs you out of every other site. You can clear just WhatsApp instead. From Google's cookie help page:
- Close any WhatsApp Web tabs.
- In Chrome, click the three-dot menu, then Settings.
- Go to Privacy and security, then Third-party cookies, then See all site data and permissions. (Shortcut: type
chrome://settings/content/allin the address bar.) - Search for whatsapp.
- Click the Delete (trash) icon next to whatsapp.com and confirm.
- Open web.whatsapp.com again and link your phone.
This logs WhatsApp Web out on this computer and removes its local copy of your chats. Nothing is deleted from your phone. Once you relink, WhatsApp Web loads your chats again from the phone, but older messages may take a while to show up, or may not show up on the computer at all. If that happens, see why WhatsApp Web isn't showing old messages.
If clearing just WhatsApp doesn't help, then do the full clear WhatsApp describes: menu, Delete browsing data, time range All time, tick Cookies and other site data and Cached images and files, then Delete data. Expect to sign back in to other sites afterwards.
4. Remove the old link from your phone
If the browser still shows the error, remove the stale session from your phone too, so you start from zero on both ends. WhatsApp's linked devices page shows how: open WhatsApp on your phone, go to Linked devices, tap the computer that's giving trouble, and tap Log out. Then open web.whatsapp.com and link again.
If your phone won't read the QR code when you relink, you can link with your phone number instead.
5. Reset Chrome, then restart the computer
These are WhatsApp's last two suggestions, and they're the heavier ones.
Reset Chrome: Settings, then Reset settings, then Restore settings to their original defaults, then Reset settings. Your bookmarks and saved passwords stay. But Google's reset page lists what does change: your search engine, homepage, pinned tabs, site permissions, cookies and site data, and extensions and themes. Expect to sign back in to some sites, and check your extensions afterwards.
Restart the computer: turn it fully off and back on, then try WhatsApp Web again.
Still stuck?
Some people keep getting the error on every browser and every computer they try. In one r/whatsapp thread, the poster said clearing cookies, switching browsers and even switching computers didn't help, and another user asked whether their internet provider could be blocking something. Nobody in the thread found a confirmed fix.
If that's you, two things are worth checking:
- Your network. WhatsApp's connection help page says office or campus Wi-Fi can cause problems, and suggests trying another network or a phone hotspot. If WhatsApp Web works on the hotspot, the network is the problem. WhatsApp's fix is to set the network to let through traffic to web.whatsapp.com and .whatsapp.net, which whoever runs the network has to do.
- Contact WhatsApp from your phone. On iPhone: your profile picture, then Help and feedback, Help Center, Contact us. On Android: the three-dot menu, Settings, Help and feedback, Help Center, Contact us.
If WhatsApp Web links but then keeps dropping you, that's a different problem. See why WhatsApp Web keeps logging you out.
FAQ
Will clearing my browser data delete my WhatsApp chats?
No. Clearing site data removes WhatsApp Web's copy of your chats on that computer. Your chats stay on your phone, and WhatsApp Web loads them again after you relink.
Why does the error come back after I relink?
If the stored database is what's broken, relinking on top of it may not help. Clear WhatsApp's site data first (step 3), then relink, so WhatsApp Web starts fresh.
Does this happen on the WhatsApp phone app?
No. The error message is about the browser's database, so it shows up on WhatsApp Web. The phone app keeps working while you fix it.
Sources
- WhatsApp Help Center, Seeing "A database error occurred on your browser"
- WhatsApp Help Center, How to fix connection issues
- WhatsApp Help Center, About linked devices
- Google Chrome Help, Delete, allow, and manage cookies in Chrome
- Google Chrome Help, Browse in Incognito mode
- Google Chrome Help, Reset Chrome settings to default
- r/whatsapp, Can no longer login in WhatsApp Web - "A database error occurred on your browser"