Is it safe to delete the Quick Look thumbnail cache?
- Yes. It holds the little previews Finder shows instead of plain icons for photos, PDFs, videos and documents. Resetting it with Apple’s
qlmanage -r cacheloses nothing you made. - What it costs you: a moment of generic icons the next time you open a folder full of pictures, while the previews are drawn again.
- Does it come back? Yes, by itself. Quick Look makes new thumbnails as you browse, so the cache fills up again.
- SiftMac’s verdict: Rebuilds
1. What it is
When Finder shows a photo, a PDF or a film as a small picture of its contents, that picture comes from Quick Look, the part of macOS that also previews a file when you select it and press Space. Drawing a thumbnail means opening the file, so macOS keeps each one it makes in a cache. The next time you open that folder, the icons appear straight away instead of being drawn again.
Everything in the cache can be made again from the file it came from. It isn’t a copy of your files, and nothing else on your Mac depends on it.
The better reason to clear it is privacy. In 2018 a security researcher showed that the cache keeps thumbnails and file paths of files from encrypted disk images and USB drives, even after the disk is unmounted and across restarts, and that qlmanage -r cache purges them.
2. Where it is
It’s in your per-user cache folder inside /private/var/folders, under a path with random letters that’s different on every Mac. Terminal prints that folder’s path for you:
getconf DARWIN_USER_CACHE_DIR
On recent versions of macOS the thumbnail cache is a com.apple.QuickLook.thumbnailcache folder inside com.apple.quicklook.ThumbnailsAgent there; older versions kept it directly in the cache folder. This finds it either way:
find "$(getconf DARWIN_USER_CACHE_DIR)" -maxdepth 2 -name com.apple.QuickLook.thumbnailcache 2>/dev/null
3. How big it gets
It holds small preview images, not copies of your files, so don’t expect much space from it. Measuring it is harder than it sounds: on recent macOS the folder is locked, and du reports “Operation not permitted” even when Terminal has Full Disk Access. On a Mac where it’s readable, this prints its size:
find "$(getconf DARWIN_USER_CACHE_DIR)" -maxdepth 2 -name com.apple.QuickLook.thumbnailcache -exec du -sh {} + 2>/dev/null
If it prints nothing, macOS isn’t letting Terminal read the folder. That’s expected; use the reset below instead of trying to open it.
4. How to delete it safely
- Open Terminal (in Applications › Utilities).
- Run
qlmanage -r cache. It resets the thumbnail cache for your account, with no password to enter and no restart needed. - If previews of one kind of file look broken as well, also run
qlmanage -r, which reloads Quick Look’s list of generators.
qlmanage -r cache
Don’t go into /private/var/folders and delete things by hand. Besides this cache, that folder holds other apps’ temporary files and caches that are in use right now.
5. What happens afterwards
- Folders full of photos, PDFs and videos show plain icons briefly, then their previews return as Quick Look draws them.
- Thumbnails of files you’ve deleted, and of files on drives or encrypted disk images that are no longer connected, are gone from the cache.
- Your files, their names and tags, and Finder’s view settings don’t change.
- The cache grows again as you browse. Reset it whenever previews look wrong, or after working with files you’d rather not leave traces of.
6. Where the space usually is instead
If you’re here because the disk is full, this cache won’t fix it. Look at app caches in your Library, the Trash and your Downloads folder first, and at the grey System Data bar, which the System Data guide breaks down part by part.
Questions
Does qlmanage -r cache delete my files?
No. It throws away the stored preview images. The photos, documents and videos they were made from stay exactly where they are.
Will resetting the cache make my Mac faster?
No, and for a little while it’s the opposite: folders of pictures fill in their icons more slowly until the thumbnails are made again. Reset it to fix wrong or stale previews, or for privacy.
Why can’t I open the folder, even with Full Disk Access?
On recent versions of macOS the folder is locked, so Terminal and Finder get “Operation not permitted”. qlmanage -r cache is Apple’s way to reset it without opening it.
Is com.apple.QuickLook.thumbnailcache malware?
No, it’s part of macOS. The com.apple. name and its place in your per-user cache folder are normal for Quick Look, the previews you see in Finder and when you press Space.
How SiftMac handles it. SiftMac leaves the Quick Look cache to macOS. Its App caches category clears folders in ~/Library/Caches and skips Apple’s own com.apple. caches; this one sits in macOS’s per-user folder under /private/var/folders, where qlmanage -r cache is the right tool.
Download SiftMac · scanning is free, and so is your first 2 GB of cleaning · See how it works