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
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" reportsThe 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 stubHEIC 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-exportRAW 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 modesPDF 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 iconVideo Files: Works in the Folder, Fails in Search
Video thumbnails fail in a genuinely different pattern than photos or documents: a reported case found MP4 and MOV files on an external SSD showing full thumbnails when the folder was browsed directly, with the exact same files showing no preview at all inside Finder's own search results, while files on the internal drive behaved normally either way. That points at Spotlight's search index for the volume, not Quick Look or the video codec, since direct browsing and search draw thumbnails through different code paths.
If your symptom matches that pattern, exclude and then re-include the affected volume under System Settings > Siri & Spotlight > Spotlight Privacy to force a reindex, then search again once indexing finishes (the menu bar Spotlight icon shows a pulsing dot while it's working).
A second, less common pattern is iPhone-sourced .mov files imported with Photos set to Keep Originals rather than Automatic; some users report these specific files lacking thumbnails until the Photos transfer setting is changed. If you're dealing with iPhone video clips specifically and the fixes above don't apply, check Photos > Settings > General for that setting before anything else.
Fixes: MP4/MOV thumbnails that appear inconsistentlySymptom → Likely Cause → Fix
Use this as a shortcut straight to your exact symptom.
| What you're seeing | Likely cause | Fix |
|---|---|---|
| Generic icon with a small cloud badge | iCloud Drive stub, file not downloaded | Control-click → Download Now, or Keep Downloaded |
| Every file type blank after a while, all at once | Stale or corrupted Quick Look thumbnail cache | qlmanage -r cache, then qlmanage -r, then relaunch Finder |
| HEIC photo from AirDrop or another app, blank | Malformed HEIC container, not a macOS bug | Export as JPEG from Preview to confirm, then re-export the source |
| Compressed RAW blank, uncompressed RAW from the same camera fine | Apple's RAW decoder gap for that compression mode | Shoot uncompressed, or check System Information > Raw Support |
| Canon CR3/CR2 shows a black rectangle after a macOS update | A known Sequoia 15.4/15.4.1 Finder regression | Resize the Finder window, or update to macOS 15.5+ |
| PDF shows the app icon, not page one | Small icon size, or an Acrobat-stripped embedded thumbnail | Increase icon size first; open once in Preview to force a rebuild |
| Video thumbnail missing only in search results | Spotlight index gap for that volume | Toggle 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.
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
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