Every time you tap the Space bar on a file in Finder to preview it, or Spotlight shows you a search result with a small image next to it, or an icon in a folder view renders as an actual thumbnail rather than a generic file icon, macOS generates and stores that preview under ~/Library/Caches/com.apple.QuickLook.thumbnailcache. On a Mac with a large photo library, years of PDFs, or a big collection of video files, this cache accumulates a thumbnail for nearly everything you've ever previewed or browsed, and it can grow to a meaningful size without you ever seeing it, because it lives inside the hidden ~/Library folder. It is also one of the least risky things you can clear on macOS: everything in it is disposable, and the system regenerates thumbnails automatically the next time it needs them. This article explains what the cache is, the command that clears it, and where it fits relative to the bigger storage sinks on a Mac.
What the cache actually stores
QuickLook is the system underneath the Space-bar preview, Finder's icon thumbnails, Cover Flow, and the small image previews Spotlight shows next to search results. Generating a full-resolution preview of a large photo or a multi-page PDF every single time you glance at it in Finder would be slow, so macOS generates it once and caches the result at ~/Library/Caches/com.apple.QuickLook.thumbnailcache. The next time you view that same file — assuming it hasn't changed — macOS reads the cached thumbnail instead of regenerating it from scratch.
This is a sensible design for responsiveness, but it means the cache grows in proportion to how much content you've browsed, not how much you actively use. Scroll through a folder of a few thousand photos once, and macOS will have generated and stored a thumbnail for every single one, whether or not you ever open any of them again.
Why it grows large on some Macs
The size of this cache correlates directly with how much browsing you do in Finder and Spotlight, and how large your files tend to be. A Mac with a large local photo library, a video editor's project folders, or years of PDF documents accumulated in Downloads and Documents will generate far more cached thumbnails than a Mac used mostly for browsing the web and writing text documents. It isn't unusual for the QuickLook cache to reach a few hundred megabytes to a couple of gigabytes on a Mac with a substantial media library, simply as a byproduct of normal use.
It's worth being clear about scale, though: this cache typically isn't in the same league as the storage sinks that actually fill a disk. Xcode's DerivedData folder or Docker Desktop's Docker.raw virtual disk can each run into tens of gigabytes on their own. The QuickLook cache is a smaller, easier win — but it's a genuine one, and unlike those developer caches, it's relevant to essentially every Mac user, not just people who write code.
Clearing it safely
The command to reset the QuickLook thumbnail cache is:
qlmanage -r cache
This tells the QuickLook subsystem to discard its cached thumbnails. There's no confirmation dialog and no risk of losing anything, because nothing in this cache is an original file — every thumbnail it contains was derived from a real file elsewhere on disk, and macOS will simply regenerate a fresh thumbnail the next time it needs one. The only visible effect is that the first preview or icon render for each file after clearing the cache takes a fraction of a second longer than usual, while macOS rebuilds it.
This makes it a genuinely unambiguous case among Mac storage cleanup: there's no version of "wait, did I need that" the way there sometimes is with, say, an old project folder or a backup you're not sure is duplicated elsewhere. It's just cached image data with no independent meaning.
A related command for when previews stop working
A different but related command is worth knowing about, because it solves a different problem. If Quick Look previews themselves start misbehaving — showing a generic file icon instead of an actual preview, or failing to preview certain file types that used to work — the fix isn't the cache command above but:
qlmanage -r
Run without cache, this reloads QuickLook's plugin registry rather than clearing cached thumbnails. QuickLook relies on a set of plugins (from macOS itself and from installed apps) to know how to generate a preview for each file type, and that registry occasionally needs a reload after installing or updating software that provides its own QuickLook plugin. It's easy to reach for the wrong one of these two commands when previews aren't working, so it's worth remembering that -r cache clears stored thumbnails, while -r alone reloads the plugin system that generates them.
Why it's easy to overlook
Everything about this cache is designed to be invisible in normal use. It lives inside ~/Library, which Finder hides by default, so unless you've explicitly shown hidden files or navigated there with Cmd+Shift+., you'd never see the Caches folder at all, let alone the specific subfolder for QuickLook. There's no menu item, no settings toggle, and no notification suggesting you might want to clear it. People hunting for lost disk space tend to check the obvious places — Downloads, Desktop, the Applications folder — and the QuickLook cache simply doesn't come up unless you already know to look for it.
That combination — genuinely safe to clear, genuinely invisible by default — is exactly the kind of thing worth checking when you're doing a periodic tidy-up, even if it isn't the first place to look when you're trying to solve an urgent "disk almost full" warning.
Conclusion / VolumeLens tie-in
The QuickLook cache won't rescue a Mac that's critically low on space, but it's a legitimate quick win with essentially zero downside, and it's a good reminder that not every gigabyte on your disk is doing something useful. Clearing it costs one command and a few seconds, and the only consequence is that your next few thumbnails take slightly longer to render.
We built VolumeLens because we wanted every folder on a Mac to be visible at a glance, including the ones hidden inside ~/Library that most people never think to check. When you scan your home folder, caches like this one show up sized honestly alongside your Photos library, your Documents, and everything else competing for space, so you can decide what's worth clearing without memorising a list of hidden paths. Take a look at what a full scan shows on /.