Quick X Folder Preview · Troubleshooting

Why Are My Thumbnails Not Showing on Mac?

HEIC, RAW, PDF, and video files each lose their Finder thumbnails for different reasons. Here is how to tell which one you have and the specific fix, not a generic "restart your Mac" list.

By Ram Velmurugan · Founder & Lead Developer, 1dot.ai

Verified against macOS 26 Tahoe·Updated October 2026·9 min read
Quick answer: Before you troubleshoot any specific file type, check whether the file is an undownloaded iCloud Drive stub, marked with a small cloud badge, since that alone explains a large share of "thumbnails just disappeared" reports and has nothing to do with Quick Look. If the file is genuinely local, run qlmanage -r cache in Terminal to rebuild the thumbnail cache, then relaunch Finder. HEIC, RAW, PDF, and video each have one or two further causes beyond that, covered below with the specific fix for each.

Editorial note: 1dot.ai makes Quick X Folder Preview, a Quick Look extension mentioned near the end of this guide. It adds preview support for file types Quick Look can't open at all, folders, archives, source code, and more; it does not change how Finder generates thumbnails for the native formats covered in this post. Every cause and fix below was checked live in October 2026 against Apple's own documentation, developer forums, or an open-source project's own issue tracker; sources are listed near the bottom.

Four Different Problems That Look the Same

"No thumbnail" in Finder is a symptom, not a diagnosis. Our main Quick Look troubleshooting guide covers the case where pressing Space does nothing at all, a different bug involving Full Keyboard Access or a stuck quicklookd process. This guide covers something narrower: Quick Look and the space bar both work fine, but specific files, usually clustered by format, show a plain generic icon in Finder's grid instead of a real preview.

That distinction matters because the fix is different for a HEIC photo than for a Canon RAW file than for a PDF, and trying the wrong one wastes time. The sections below are ordered from the cause that explains the most reports to the ones specific to a single file type.

Check for an iCloud or Network Stub First

Before touching any file-format fix below, rule out the single most common cause of missing thumbnails: the file hasn't actually finished downloading. Apple's own Mac User Guide explains that when iCloud Drive's Optimize Mac Storage setting is on and local space runs low, macOS removes the local copy of files you haven't opened recently and leaves a small stub behind, marked with a cloud status icon. A stub has no image data on disk for Finder to draw a thumbnail from, which looks identical to a broken preview until you notice the cloud badge.

The same thing happens, for a different reason, on network shares and NAS volumes: an Apple Developer Forums thread on this exact behavior notes that generating a thumbnail for a file on a network share can force Finder to download the entire file just to build the preview, which some setups block or throttle, producing the same blank-icon symptom for large files specifically.

Control-click the file and look for Download Now in the menu. If it's there, the file is a stub. Choose it, wait for the file to finish downloading, and the real thumbnail appears without touching Quick Look at all.

Covers most "thumbnails vanished overnight" reports

The Universal Reset: Rebuild the Thumbnail Cache

Finder's icon-grid thumbnails and the full-size preview you get by pressing Space both come from the same Quick Look generator system, cached per user in a randomized folder under /var/folders named com.apple.QuickLook.thumbnailcache. A corrupted or stale entry in that cache can make one specific file, or an entire folder, show a stale or generic icon even though the underlying file is perfectly readable.

Open Terminal and run the two commands below, then relaunch Finder (hold Option, right-click the Finder icon in the Dock, choose Relaunch). This touches nothing about your actual files; it only tells macOS to redraw cached preview images the next time they're needed, which costs a few seconds per folder the first time you open it again.

qlmanage -r cache qlmanage -r

If that clears it, you're done. If specific formats are still blank, the cause is further down this list.

Try this next for anything that isn't a stub

HEIC Photos: When the Thumbnail Never Builds

Most HEIC photos straight from an iPhone or iPad preview fine, since macOS and iOS share the same HEIC encoder. The cases that fail are usually photos that passed through a different tool, an older third-party editor, a batch converter, or an AirDrop from an app that repackaged the file. A reported case on the libheif open-source project's own GitHub tracker found a sharper version of this: HEIC files re-encoded from JPEGs with odd pixel dimensions would not open in Preview at all, with macOS reporting the file as damaged, while the exact same files converted cleanly to JPEG with a different tool. The maintainer traced it to a mismatch in how the two encoders handle non-even dimensions, not file corruption, and shipped an encoder fix. The practical lesson carries over to thumbnail-only failures: a HEIC that previews fine elsewhere but not in Finder usually has something unusual about the container, not the image data.

A separate, much simpler cause catches people more often than the technical one: Finder's View Options panel (Cmd+J) has a Show Preview checkbox that must be ticked for that specific folder, and some users have reported that a corrupted .DS_Store file in a folder can leave this setting effectively stuck off. Reopen View Options for the affected folder, confirm Show Preview is checked, and if it already is, try toggling it off and back on.

If neither fixes it, nudge the thumbnail size slider down and back up (Cmd+J, drag the Icon Size slider) to force a rebuild, which several users on Adobe's own community forums report working for stubborn individual thumbnails. As a last resort, export the photo as JPEG from Preview; if the JPEG shows a thumbnail and the HEIC still doesn't, the HEIC file itself, not your Mac, is the problem.

Fixes: photos that came from AirDrop, a third-party app, or a re-export

RAW Files: Your Camera, Not Your Settings

Finder's RAW thumbnails come entirely from Apple's own RAW decoder, shipped as periodic Digital Camera RAW Compatibility updates, which is a completely separate codebase from Adobe Camera Raw. That's why the same RAW file can preview perfectly in Lightroom or Bridge while showing nothing in Finder, or the reverse. Before assuming a bug, check System Information (hold Option, Apple menu > System Information) under Software > Raw Support, which lists every camera model and RAW variant your current macOS version actually supports.

Being on that list isn't always enough. A case reported on Adobe's own community forum in October 2025 found a Fujifilm X-E5 listed as supported on macOS Tahoe 26.0.1, yet only its uncompressed RAF files generated Finder thumbnails; compressed RAF files from the same camera, same macOS version, showed only the generic RAW icon. The reporter's camera was set to the default lossless-compressed mode. If your camera supports both compressed and uncompressed RAW, switching to uncompressed is worth testing directly.

Separately, Canon CR3 (and some CR2) thumbnails started showing a black rectangle instead of the image in Finder and Quick Look for multiple users after the macOS Sequoia 15.4 and 15.4.1 updates, a regression documented in a long Apple Support Communities thread rather than a one-off. Manually resizing the Finder window brought the preview back for some people, though slowly, and a few reported that switching the display's color preset to Photography helped; several users reported the issue gone after updating to macOS 15.5 or 15.6, though that is an unconfirmed user report rather than an Apple release note. If you hit something similar, check for a pending macOS update before trying anything else.

Fixes: RAW thumbnails missing for specific cameras or compression modes

PDF Documents: Generic Icon Instead of Page One

PDFs have two distinct failure modes, and they need different fixes. The first is purely cosmetic: a forum-reported case found a PDF showing only the generic file icon at Finder's default icon size, with the actual first-page thumbnail appearing once the icon size was increased with the slider under Cmd+J. If you're on a small icon size, try the largest setting before concluding anything is broken.

The second is specific to PDFs that went through Adobe Acrobat's optimization or "fast web view" processing, which can strip the embedded thumbnail image to shrink file size. Finder then has no pre-rendered image to show and falls back to the generic app icon. Opening the file once in Preview typically forces macOS to regenerate a thumbnail from the actual page content; if that doesn't stick, re-exporting the PDF without the optimization setting fixes it at the source.

If both of those come back clean and the cache reset above didn't help either, resetting NVRAM or PRAM has fixed stuck generic icons for some users according to reports referencing Apple's own NVRAM reset support article, though this is a broader, lower-probability fix worth trying only after the PDF-specific checks above.

Fixes: PDFs stuck on the Preview or Acrobat app icon

Symptom → Likely Cause → Fix

Use this as a shortcut straight to your exact symptom.

What you're seeingLikely causeFix
Generic icon with a small cloud badgeiCloud Drive stub, file not downloadedControl-click → Download Now, or Keep Downloaded
Every file type blank after a while, all at onceStale or corrupted Quick Look thumbnail cacheqlmanage -r cache, then qlmanage -r, then relaunch Finder
HEIC photo from AirDrop or another app, blankMalformed HEIC container, not a macOS bugExport as JPEG from Preview to confirm, then re-export the source
Compressed RAW blank, uncompressed RAW from the same camera fineApple's RAW decoder gap for that compression modeShoot uncompressed, or check System Information > Raw Support
Canon CR3/CR2 shows a black rectangle after a macOS updateA known Sequoia 15.4/15.4.1 Finder regressionResize the Finder window, or update to macOS 15.5+
PDF shows the app icon, not page oneSmall icon size, or an Acrobat-stripped embedded thumbnailIncrease icon size first; open once in Preview to force a rebuild
Video thumbnail missing only in search resultsSpotlight index gap for that volumeToggle the volume in Spotlight Privacy to force a reindex

Where Quick X Folder Preview Fits In

It's worth being direct about this: Quick X Folder Preview does not fix any of the causes above. HEIC, RAW, PDF, and video are formats Quick Look already supports natively, so the problem is always somewhere in how macOS reads that specific file or cache entry, not a missing preview extension.

Honest status
What Quick X Folder Preview actually adds is the 13 formats Quick Look has no built-in support for at all, folders, archives, source code, Markdown, Jupyter notebooks, and more, triggered by the same Space key. If your blank thumbnails are on a .zip, a folder, or a .ipynb file rather than a photo or video, that's a different problem this app does solve; $4.99 once after a 14-day trial, macOS 13.0 or later.

Sources & Further Reading

iCloud Drive stub files and the cloud status icon: Apple Mac User Guide, Change iCloud Drive storage settings.

Network-share thumbnails forcing a full file download: Apple Developer Forums, Finder triggering full download for thumbnails.

Quick Look thumbnail cache location and the qlmanage reset command: Wikipedia, Quick Look.

HEIC files failing to open at all due to an odd-dimension encoder mismatch, not file corruption: libheif GitHub Issue #331.

Fujifilm X-E5 compressed RAF thumbnails missing on macOS Tahoe 26.0.1: Adobe Community, "New camera RAW files".

Canon CR3/CR2 Finder preview regression on macOS Sequoia 15.4/15.4.1: Apple Support Communities, "CR3 Previews Not Working in Finder After macOS 15.4 and 15.4.1 Updates".

MP4/MOV thumbnails missing only in Finder search on an external SSD: Habr Q&A, Finder search thumbnail report.

If Space does nothing at all rather than showing a blank icon, see our main Quick Look troubleshooting guide instead.

Frequently Asked Questions

Why do some photos in the same folder show thumbnails and others just show a generic icon?
This is almost always iCloud Drive's Optimize Mac Storage at work, not a Quick Look bug. Apple's own Mac User Guide describes files that exist only in iCloud as showing a cloud status icon; once evicted to save local space, the file becomes a small stub and Finder has nothing to generate a thumbnail from until it is downloaded again. Control-click the affected file and choose Download Now, or select it and choose File > Keep Downloaded if you want it to stop happening to that file specifically.
Why don't my HEIC photos show thumbnails after I imported them from a different app?
A HEIC file that was re-encoded or repackaged by a third-party tool can end up with a container macOS's own HEIC reader doesn't parse the way it parses photos straight from an iPhone. A reported case on the libheif project's own GitHub tracker traced exactly this kind of failure, HEIC files that wouldn't open in Preview at all, to a mismatch in how the encoder handled odd pixel dimensions rather than actual file corruption. Converting the file (Preview > File > Export, or a batch tool) is the reliable fix when nothing else here helps, and if the JPEG opens cleanly while the HEIC doesn't, the HEIC container itself is the problem, not your Mac.
My RAW files show thumbnails in Lightroom but not in Finder. Why the difference?
Finder's thumbnails depend entirely on Apple's own RAW decoder, which is separate from Adobe Camera Raw and gets updated on its own schedule through Digital Camera RAW Compatibility updates. Adobe's decoder and Apple's decoder support overlapping but not identical camera and compression combinations, so a file can preview perfectly in Lightroom or Bridge while Finder shows nothing for the same file. Check System Information > Software > Raw Support to see the exact camera models and formats your current macOS version supports before assuming something is broken.
Why did my Canon RAW thumbnails disappear after updating macOS?
A real regression affected CR3 (and some CR2) Finder and Quick Look previews on macOS Sequoia 15.4 and 15.4.1, showing a black rectangle instead of the photo, documented by multiple users in a long Apple Support Communities thread. Manually resizing the Finder window brought the preview back for some people, slowly; several reported the issue gone after updating to macOS 15.5 or 15.6. If you hit something similar on a current release, check for a pending macOS update first.
Why does my PDF show a generic icon instead of a thumbnail of the first page?
Two separate causes produce this. First, Finder's icon-size setting matters more than people expect; a forum-reported case found a PDF showing only the generic icon at a small icon size, with the real first-page thumbnail appearing once the icon size was increased. Second, some PDFs created or optimized by Adobe Acrobat ship with their embedded thumbnail stripped out to save file size, in which case Finder has no image data to draw from until you open the file once in Preview to force regeneration, or re-export it without that optimization.
Why do my video thumbnails show up when I browse a folder but disappear when I search for the same file?
This one is a genuine, narrow Finder bug rather than a codec or cache problem: a reported case found MP4 and MOV files on an external SSD showing full thumbnails during normal folder browsing, with the exact same files showing no preview at all inside Finder's own search results. The affected files were specifically being surfaced through Spotlight search indexing rather than direct directory listing. If this matches your symptom, try rebuilding the Spotlight index for that volume under System Settings > Siri & Spotlight > Spotlight Privacy, by adding and then removing the drive from the privacy list.
Will resetting the Quick Look thumbnail cache delete any of my actual files?
No. The cache that `qlmanage -r cache` clears is a per-user folder of generated preview images macOS keeps separately from your real files, stored under a randomized path inside /var/folders. Deleting or resetting it only means macOS has to redraw each thumbnail from the original file the next time Finder needs one, which takes a few seconds per folder and touches nothing about the files themselves.

The Bottom Line

Missing thumbnails almost never have one universal fix, because photos, RAW files, PDFs, and video clips fail for different, specific reasons. Check for the iCloud cloud badge first, since it accounts for a large share of reports and needs no troubleshooting at all beyond a download. If the file is genuinely local, the cache reset clears most of what's left. Anything that survives both steps is almost always format-specific, and the sections above name the actual cause rather than asking you to restart your Mac and hope.


Looking for more Mac productivity guides? Read our main Quick Look troubleshooting guide, our full guide to previewing files on Mac without opening them, browse every 1dot.ai guide, or check Quick X Folder Preview's product page for pricing and the full extension list.

Thumbnails Fixed? See What Quick Look Still Can't Open

Quick X Folder Preview adds 13 Quick Look extensions for formats Finder has no preview for at all: folders, archives, code, Markdown, and more. Free for 14 days, then $4.99 once for a lifetime license.

Try It FreeRead More Guides