Skip to content

Finder builds a thumbnail for everything, and keeps them in one cache

Preview images for every file you have looked at accumulate in a system cache. Where it is, when to reset it, and what resetting costs.

4 min read

Every time Finder shows a preview, a Space bar QuickLook, or a Cover Flow style thumbnail, macOS generates an image and caches it. The cache is bounded in principle and grows steadily in practice, particularly on a Mac used for photography or video.

Where it lives

du -sh $(getconf DARWIN_USER_CACHE_DIR)/com.apple.QuickLook.thumbnailcache 2>/dev/null
du -sh ~/Library/Caches/com.apple.QuickLook* 2>/dev/null

The first path is the one that matters and the reason people cannot find this folder: it is inside the per user temporary area with a randomly named path, not in your Library. getconf DARWIN_USER_CACHE_DIR prints it, which is the only reliable way to get there.

Resetting it properly

qlmanage -r cache

That is the supported reset. It clears the store and lets macOS rebuild as you browse. Deleting the folder by hand while Finder is running is the version that produces missing previews until the next restart.

When it is worth doing

  • Previews are wrong or blank. A stale thumbnail cache is the usual cause, and resetting it is the standard fix.
  • The folder is genuinely large. On a Mac that has browsed tens of thousands of images or video files it can reach gigabytes.
  • After deleting a lot of media. The cache does not shrink when the originals go.

What it is not is a fix for a full disk. It is a cache in the ordinary sense: the same trade every cache offers, which is space now against slower previews later.

The neighbours in the same folder

That per user cache directory holds more than thumbnails, and it is part of the temporary area macOS never mentions. A restart clears much of it safely, which is worth trying before any command.

Common questions

Where is the QuickLook thumbnail cache on a Mac?

Inside the per user cache directory, which has a randomly generated path. Run getconf DARWIN_USER_CACHE_DIR to print it, then look for com.apple.QuickLook.thumbnailcache inside. It is not in your Library folder, which is why it is hard to find.

How do I clear the thumbnail cache on a Mac?

Run qlmanage -r cache. That is the supported reset and lets macOS rebuild previews as you browse. Deleting the folder by hand while Finder is running leaves blank previews until you log out.

Why are my Finder previews blank or wrong?

Usually a stale QuickLook cache. Resetting it with qlmanage -r cache is the standard fix, and previews are regenerated the next time you look at the files.

Does clearing the thumbnail cache free much space?

Rarely more than a gigabyte or two, and it grows back as you browse. It is worth doing to fix broken previews, not as a strategy for a full disk.

Read next