If WhatsApp Desktop keeps crashing on your Windows PC or Mac, the fix is usually a combination of clearing the app cache, updating the app, and checking your system’s date/time settings. Below are the most effective troubleshooting steps, starting with the quickest and moving to more advanced solutions.
Why Does WhatsApp Desktop Crash?
WhatsApp Desktop is an Electron-based app, meaning it runs a Chromium browser engine inside a native wrapper. This architecture makes it powerful but also prone to crashes caused by corrupted cache files, outdated app versions, graphics driver issues, or conflicts with other software. Common triggers include:
- Corrupted cache or local storage – Old temporary files can become incompatible after an update.
- Outdated app version – Bugs are fixed in new releases; running an old version invites crashes.
- System date/time mismatch – WhatsApp’s encryption handshake fails if your clock is off by more than a few minutes.
- Graphics driver problems – Hardware acceleration can cause rendering crashes on some GPUs.
- Interference from antivirus or VPN – Security software may block WhatsApp’s network connections unexpectedly.
Step 1: Restart and Update WhatsApp Desktop
The simplest fix is often the most effective. Close WhatsApp Desktop completely (check the system tray or menu bar for a lingering icon) and reopen it. If the crash persists, check for updates:
- Open WhatsApp Desktop and click the three-dot menu (Windows) or the WhatsApp menu (Mac).
- Select Settings → Help → Check for updates.
- If an update is available, install it and restart the app.
On Windows, you can also check the Microsoft Store for updates if you installed it from there. On Mac, the App Store handles updates automatically if enabled.
Step 2: Clear the App Cache (Without Losing Chats)
Corrupted cache files are a leading cause of crashes. Clearing them does not delete your chat history – that is stored on your phone and synced to the cloud. The cache only contains temporary data like images and previews.
On Windows:
- Close WhatsApp Desktop completely.
- Press
Win + R, type%appdata%\WhatsApp, and press Enter. - Delete the Cache folder (you can rename it to
Cache.oldinstead if you want to be safe). - Restart WhatsApp Desktop.
On Mac:
- Close WhatsApp Desktop.
- Open Finder, press
Cmd + Shift + G, and enter~/Library/Application Support/WhatsApp. - Delete or rename the Cache folder.
- Restart the app.
Step 3: Check Your System Date and Time
WhatsApp uses end-to-end encryption, which relies on your device’s clock to validate message timestamps. If your date or time is incorrect, the app may crash or fail to connect. On both Windows and Mac, set the clock to automatic:
- Windows: Settings → Time & Language → Date & time → toggle on “Set time automatically” and “Set time zone automatically”.
- Mac: System Settings → General → Date & Time → toggle on “Set time and date automatically”.
Step 4: Disable Hardware Acceleration
Hardware acceleration offloads rendering to your GPU, but some graphics drivers have bugs that cause crashes. Disabling it often stabilizes the app.
- Open WhatsApp Desktop.
- Go to Settings → General.
- Turn off Hardware acceleration.
- Restart the app.
If the app crashes before you can reach settings, you can force-disable it by editing the config file:
- Close WhatsApp, then open
%appdata%\WhatsApp\settings.json(Windows) or~/Library/Application Support/WhatsApp/settings.json(Mac) in a text editor. - Find the line
"hardwareAccelerationEnabled": trueand change it tofalse. - Save the file and restart WhatsApp.
Step 5: Reinstall WhatsApp Desktop
If the above steps fail, a clean reinstall often resolves deep corruption. Uninstall the app, then download the latest version from the official WhatsApp website (or your app store). Your chat history is stored on your phone and will re-sync when you log in.
- Uninstall WhatsApp Desktop via Settings → Apps (Windows) or by dragging it to Trash (Mac).
- Restart your computer to clear any lingering processes.
- Download and install the latest version from
whatsapp.com/download. - Log in by scanning the QR code with your phone.
Step 6: Update Graphics Drivers and Disable Conflicting Software
Outdated GPU drivers can cause crashes in Electron apps. Update your graphics drivers from the manufacturer’s website (NVIDIA, AMD, Intel) or via Windows Update. Also, temporarily disable any antivirus or VPN software to see if the crash stops. If it does, add WhatsApp to the exception list.
Step 7: Use WhatsApp Web as a Temporary Alternative
While you troubleshoot, you can use web.whatsapp.com in your browser. It offers the same core features (chat, media, voice notes) and works independently of the desktop app. This lets you stay connected without waiting for a fix.
Frequently Asked Questions
Will clearing the cache delete my messages?
No. Your chat history is stored on your phone and synced to WhatsApp’s servers. The cache only contains temporary media and previews. Clearing it may cause images to re-download, but your conversations remain intact.
Why does WhatsApp Desktop crash on startup?
This usually indicates corrupted cache or an outdated app version. Try clearing the cache folder as described in Step 2, then check for updates. If it still crashes, reinstall the app.
Does WhatsApp Desktop work on Mac with Apple Silicon?
Yes, WhatsApp provides a native version for Apple Silicon (M1/M2/M3) Macs. If you’re using an older Intel version, download the current build from the official website to avoid compatibility issues.
Can I use WhatsApp Desktop without my phone?
No. WhatsApp Desktop requires your phone to be connected to the internet to sync messages. It is a companion app, not a standalone client.
Why does WhatsApp Desktop crash when I try to send a file?
This could be due to a corrupted file or a temporary glitch. Try sending a different file, or clear the cache and restart the app. If the issue persists, check if the file path contains special characters – rename the file to something simple and try again.
Is there a way to recover unsent messages after a crash?
Messages that were in the process of being sent are usually lost if the app crashes. However, once sent, they are stored on your phone and will appear in the chat history after reconnecting.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- Gmail Notifications Not Working? Fixes That Work
- Fix Thumbnails Not Showing on Network Drives in Windows 11
- Stop Skype Auto-Start in Windows: 5 Fixes
- Print iMessage or Text Conversations on iPhone & iPad
- Madden 20 Crashes on PC: Solved?
- SQL Injection Prevention: Step-by-Step Guide