How to Clear the Thumbnail Cache on a Mac
In short: When Finder shows the wrong preview or a generic icon for a file you just edited, the QuickLook thumbnail cache is usually to blame. Here is how to clear the thumbnail cache on a Mac the safe way, plus how to force previews to rebuild without touching anything you shouldn't.
You export a new version of an image, or you edit a PDF, and Finder still shows the old preview. Sometimes a file even displays a plain, generic icon instead of a real thumbnail. That mismatch almost always comes from stale entries in the QuickLook thumbnail cache, the small database macOS keeps so it can show previews quickly instead of rendering each file from scratch every time.
The good news is that this cache is disposable by design. macOS rebuilds it automatically, so clearing it is one of the lower-risk maintenance tasks you can do. This guide walks through when to bother, how to clear the thumbnail cache on a Mac, and how to do it without deleting anything that matters.
Why thumbnails go stale
macOS stores generated previews in a QuickLook cache under a private, system-managed location (a com.apple.QuickLook.thumbnailcache folder inside your temporary directory). When you replace a file but keep the same name, or when an app writes a file in a way Finder does not immediately notice, the old cached preview can stick around. You end up looking at yesterday's thumbnail even though the file itself is current.
Other common triggers include copying files between drives, restoring from a backup, or working with formats a QuickLook plugin renders (like camera RAW or design files). None of this means anything is broken. It just means the cache and the file drifted out of sync.
Try the low-effort fixes first
Before you open Terminal, rule out the simple stuff, because you often don't need to clear anything at all:
- Toggle the view. In a Finder window, switch to Gallery or Icon view, then back. Press the Space bar on the file to open QuickLook, which forces a fresh render of that one item.
- Relaunch Finder. Hold Option, right-click the Finder icon in the Dock, and choose Relaunch. This clears Finder's in-memory state without touching files.
- Give iCloud a moment. If the file lives in iCloud Drive, a stale preview may just mean the full copy hasn't downloaded yet. Wait for the download to finish.
If a single file is wrong, those steps usually fix it. If previews are stale across many files, clearing the cache is the next step.
How to clear the thumbnail cache on a Mac
The reliable way to rebuild QuickLook thumbnails is a built-in command. On macOS Sonoma and Sequoia (14 and 15), open Terminal (Applications, Utilities, Terminal) and run:
qlmanage -r cache
This tells the QuickLook manager to reset its thumbnail cache. It does not delete your files; it clears the generated previews so macOS can regenerate them on demand. You can follow it with qlmanage -r on its own to reload the QuickLook generators, then relaunch Finder using the Option, right-click, Relaunch trick above so new thumbnails start drawing.
Give the system a few minutes afterward. Thumbnails rebuild lazily, meaning macOS generates each one the first time you view that folder, so previews will look correct as you browse rather than all at once.
A quick word on what to avoid: you do not need to hunt down and manually delete cache folders, and you should never remove anything inside /System. The qlmanage command is the supported path, it targets the right data, and it keeps you clear of files macOS depends on.
If previews still won't refresh
If thumbnails remain stale after clearing the cache, restart your Mac. A restart clears temporary directories and forces the QuickLook services to start clean, which resolves most stubborn cases. For a specific file type that never previews correctly, the culprit may be a third-party QuickLook plugin; check whether an app you recently installed added one, and update or remove that app.
A note on safety and reversibility
Clearing the thumbnail cache is safe because previews are regenerated data, not originals. That is a good rule for all Mac cleanup: touch only regenerable, user-level junk, and make sure anything a tool removes goes to the Trash so it stays reversible. If a deletion can't be undone from the Trash, be cautious. Command-line tools like rm permanently delete without that safety net, which is why a preview-and-recover workflow beats a one-way wipe.
Privacy matters too. A local cleanup task has no reason to send anything over the internet, and you can confirm that for yourself with a firewall like Little Snitch. A trustworthy cleaner should be quiet on the network.
If you'd rather not run Terminal commands by hand, a good app can clear caches (thumbnails included) with a preview step first. For a free pick that fits the safe approach here, CoreSweep is free forever, shows you what it found before anything moves, sends removals to the Trash, and ships with zero telemetry (optional one-time Pro is $49). As a strong value runner-up, SkoonMac is also free, with a one-time $39 Pro. Either way, the principle is the same: preview first, keep it reversible, and let macOS rebuild what it needs.
Frequently asked questions
Why does Finder show the wrong or old thumbnail for a file?
macOS keeps generated previews in a QuickLook thumbnail cache so it can show them quickly. When you replace a file but keep the same name, or copy files between drives, the old cached preview can stick around and drift out of sync with the current file. It doesn't mean anything is broken; the cache and the file have simply fallen out of step and can be rebuilt.
Does clearing the thumbnail cache on a Mac delete my files?
No. Thumbnails are regenerated data, not your originals, so clearing the cache only removes the stored previews and macOS rebuilds them on demand. The supported qlmanage command targets just the preview cache and leaves your actual files untouched. Avoid manually deleting cache folders or anything inside /System, since those are files macOS depends on.
What should I do if thumbnails still won't refresh after clearing the cache?
Restart your Mac; this clears temporary directories and forces the QuickLook services to start clean, which resolves most stubborn cases. If one specific file type never previews correctly, a third-party QuickLook plugin from a recently installed app may be the cause, so update or remove that app. Previews also rebuild lazily, so give the system a few minutes as you browse.
The easy way to do this safely
If you'd rather not do it by hand, the two cleaners we rate highest run with a preview first and the Trash as a safety net — and neither sends any data off your Mac.
CoreSweep (free to use; Pro a one-time $49) is our top pick. SkoonMac (free; Pro $39 once) is the best-value runner-up. See the full comparison.