WhatsApp Desktop on Mac quietly accumulates gigabytes of cached images, videos, voice notes, and stickers over time. If your Mac's storage indicator is red, or macOS keeps warning you about low disk space, WhatsApp's cache folder is a common culprit. This guide gives you the exact folder paths, step-by-step clearing instructions, and the settings you need to change so the cache does not balloon straight back to its original size.
Why WhatsApp Desktop Stores So Much on Your Mac
Every image, video, sticker pack, and voice message that passes through a WhatsApp chat gets written to disk so it can display quickly without re-fetching from the network. WhatsApp Desktop also keeps a separate SQLite database for your chat history, and a growing pile of app-support files for things like contact thumbnails and link previews. On an active account, the total footprint can reach 5 to 15 GB or more within a few months.
The data splits roughly into two buckets:
- The cache folder (
~/Library/Caches/net.whatsapp.WhatsApp): temporary render data, thumbnail grids, and network response caches. Safe to delete at any time. - Application Support (
~/Library/Application Support/WhatsApp): your actual chat database (ChatStorage.sqlite), downloaded media, and account credentials. This is the folder you want to touch carefully.
Most guides stop at "clear the cache" without explaining which folder is which. The sections below cover both, clearly.
How to Clear the WhatsApp Cache on Mac (Step by Step)
Step 1: Quit WhatsApp completely
Before deleting any files, make sure WhatsApp is not running. Click the WhatsApp icon in your Dock or menu bar, then choose Quit WhatsApp. To confirm it is fully stopped, open Activity Monitor (Spotlight: Command + Space, type "Activity Monitor"), search for "WhatsApp", and verify no process is listed.
Step 2: Open the cache folder in Finder
In Finder, press Command + Shift + G to open the "Go to Folder" dialog. Paste this path and press Return:
~/Library/Caches/net.whatsapp.WhatsAppYou will land directly in WhatsApp's cache directory. Select all contents with Command + A, then move them to the Trash with Command + Delete. Empty the Trash when you are done.
If the folder does not appear, WhatsApp Desktop may be installed as a Mac App Store app, which sandboxes its cache under a different path:
~/Library/Containers/net.whatsapp.WhatsApp/Data/Library/CachesCheck both locations. On macOS Sonoma, Sequoia, and Tahoe (2026), the sandbox path is the more common one for App Store installs.
Step 3: Clear downloaded media (optional but high-impact)
Downloaded media is stored in Application Support, not the cache folder. It will not be removed by the step above. To access it:
~/Library/Application Support/WhatsApp/MediaOr, for sandboxed installs:
~/Library/Containers/net.whatsapp.WhatsApp/Data/Library/Application Support/WhatsApp/MediaInside you will find subfolders organized by media type: WhatsApp Images, WhatsApp Video, WhatsApp Audio, and WhatsApp Documents. Sort by size (View menu, "as List", then click the Size column) to find the largest folders. You can safely delete media from these folders. WhatsApp will simply not display previews inline for those files, but your chat text and history remain completely untouched.
Do not delete ChatStorage.sqlite or ChatStorage.sqlite-wal. Those files are your message database.
Step 4: Use Terminal for a faster bulk delete
If you prefer the command line, open Terminal and run these two commands. The first clears the standard cache path, the second clears the sandboxed cache path. Both are safe to run even if one folder does not exist on your machine.
rm -rf ~/Library/Caches/net.whatsapp.WhatsApp/*
rm -rf ~/Library/Containers/net.whatsapp.WhatsApp/Data/Library/Caches/*To also clear media downloads in one pass:
rm -rf ~/Library/Application\ Support/WhatsApp/Media/*
rm -rf ~/Library/Containers/net.whatsapp.WhatsApp/Data/Library/Application\ Support/WhatsApp/Media/*Re-launch WhatsApp after running these commands. The app will rebuild its cache from scratch as you use it.
How to Stop WhatsApp Re-Downloading All That Media
Clearing the cache once is useful. Changing WhatsApp's download behavior is what prevents the problem from returning in a week.
Turn off automatic media downloads
Open WhatsApp Desktop and go to WhatsApp menu (top-left) > Preferences > Notifications and Storage. In the Storage section you will find toggles for automatic download of photos, videos, audio files, and documents. Disable all four categories, or at minimum disable video and documents, which account for the bulk of storage growth.
With auto-download off, media only lands on disk when you explicitly click to view or play it. That single change can cut monthly storage growth by 80 to 90 percent for most users.
Reduce the media retention period
In the same Preferences pane, look for a "Manage Storage" or "Storage Usage" link. WhatsApp Desktop (as of 2026 builds) shows a breakdown by chat and lets you delete media for specific conversations without touching the messages. Clearing out a few high-volume group chats this way is faster than hunting files in Finder.
Move WhatsApp media storage to an external drive
WhatsApp Desktop does not natively support redirecting its media folder to an external location. However, you can use a symlink to move the heaviest subfolder (WhatsApp Video) to an external SSD and leave a pointer in its original location:
mv ~/Library/Application\ Support/WhatsApp/Media/WhatsApp\ Video /Volumes/ExternalDrive/WhatsApp\ Video
ln -s /Volumes/ExternalDrive/WhatsApp\ Video ~/Library/Application\ Support/WhatsApp/Media/WhatsApp\ VideoReplace /Volumes/ExternalDrive with the actual mount path of your drive. The external drive must be mounted whenever WhatsApp is running or the app will recreate the folder locally.
Checking WhatsApp Desktop Storage from macOS System Settings
macOS has a built-in storage breakdown that is worth checking before and after a cleanup. Go to Apple menu > System Settings > General > Storage. Click the information icon next to "Applications" to see per-app storage, and look at the "Documents" category for media files that macOS classifies outside the application bundle.
This view gives you a quick sense of whether WhatsApp Desktop is the biggest offender or whether something else (like Xcode derived data, iOS device backups, or Zoom recordings) deserves your attention first. It does not show you the cache folder directly, which is why the manual Finder approach above is still necessary for a thorough clean.
What to Expect After Clearing the Cache
When you first relaunch WhatsApp after clearing the cache, the app may feel slightly slower for a minute or two while it rebuilds thumbnails and reloads contact photos. This is normal. Your messages, contacts, and any media you did not delete will still be there. WhatsApp re-downloads media on demand as you scroll through conversations, which is exactly the behavior you want: nothing is permanently lost, but disk space is reclaimed.
How much space you recover depends on your usage. Light personal accounts typically free up 500 MB to 2 GB. Heavy business accounts or anyone in large group chats can recover 10 GB or more.
Keeping WhatsApp Storage Under Control Over Time
The two habits that make the biggest difference are: turning off automatic media downloads (covered above) and doing a manual cache clear every two to three months. Set a calendar reminder, run the Terminal commands from Step 4, and you will rarely see WhatsApp show up as a storage problem again.
If you want a faster way to see exactly how much each app's cache weighs and clear several at once, Crumb's whole-disk map surfaces WhatsApp's cache folder alongside every other cache on your Mac. It leaves your chat database and media intact and shows you a reviewable list before removing anything, so nothing disappears without your say-so. Crumb runs entirely on-device and needs no account.