How to Fix Image Thumbnails Not Showing on Mac
Restore Finder image thumbnails safely: test Preview, inspect the preview pane, isolate file issues, and troubleshoot without guessing.
First, open one affected image in Preview. If Preview opens it, the file is readable and the missing Finder thumbnail is a separate display or thumbnail-generation problem. Then select the same file in Finder and show the preview pane. This separates three different things: the image file itself, Finder’s preview pane, and the small thumbnail drawn inside an icon.
A generic Finder icon does not prove that an image is damaged. macOS uses Quick Look thumbnailing for Finder and Spotlight, while Preview is a separate app for opening images. Use the checks below before deleting caches, changing file associations, or converting files.
1. Confirm that the image file opens
- In Finder, select a representative image whose icon is generic.
- Press
Command-O, or Control-click the file and choose Open With → Preview. - If Preview displays the image, record that result. It proves Preview can read this file, but it does not prove Finder’s thumbnail service is working.
- If Preview cannot open it, verify that you selected the intended file and note the extension, location, and macOS version before troubleshooting further.
Apple documents Preview as the built-in way to view images and PDFs: View PDFs and images in Preview on Mac.
2. Check Finder’s preview pane
- Open the folder containing the image.
- Use Finder’s View menu to show the Preview pane. The exact menu wording can vary by macOS release.
- Select the affected image.
- Compare what the pane shows with the small icon.
If the preview pane shows the image but the icon remains generic, focus on Finder icon previews or thumbnail generation. If both are blank while Preview works, the problem affects more of Finder’s preview path. Apple’s guide explains how the Finder preview pane displays a selected item’s preview and details: Use the Preview pane in the Finder on Mac.
3. Determine whether the problem is narrow or broad
| Check | What to record | Why it helps |
|---|---|---|
| One file versus many | Whether other images in the same folder show thumbnails | Separates a file-specific symptom from a Finder-wide symptom. |
| Preview result | Whether Preview opens the file | Tests readability outside the icon. |
| Preview-pane result | Whether Finder’s pane displays the image | Separates pane rendering from icon rendering. |
| File details | Extension, location, and whether the file was recently copied or downloaded | Provides useful evidence without assuming a format is unsupported. |
| System context | macOS version and whether the issue began after an update | Helps Apple Support or an administrator reproduce the symptom. |
Compare an affected image with one that does show a thumbnail. This is a diagnostic comparison, not proof that a particular format is unsupported: the available Apple documentation does not provide a complete, current compatibility matrix for every still-image format and macOS release.
4. Check icon-view preview settings
In the affected folder, switch to icon view and open the view options from Finder’s View menu. On macOS versions that expose it, look for an option named Show icon preview and enable it. Menu labels and available controls can change between releases, so use the wording shown by your version of Finder.
This setting controls whether Finder draws a content preview inside an icon. It is independent of whether Preview can open the file and independent of the preview pane.
5. Understand Quick Look thumbnailing
Finder and Spotlight can request thumbnails from macOS’s Quick Look Thumbnailing system. Apple’s developer documentation describes this framework and its use for generating thumbnails: Quick Look Thumbnailing.
A generic icon can therefore mean that a thumbnail was not available to Finder at that moment. The symptom alone does not identify why. Avoid claiming that a damaged cache, an unsupported format, or a failed update is the cause until the Preview and preview-pane checks narrow it down.
6. Handle cache-reset advice carefully
Online instructions often recommend deleting Quick Look caches or running shell commands. The reviewed Apple material establishes what thumbnailing does, but it does not establish a universal cache-reset command for still-image thumbnails. A third-party QuickLookVideo troubleshooting page discusses cache clearing in the context of non-native video support, which is a different problem.
Do not treat that video-specific command as an Apple-verified fix for still images. If you are considering any cache reset from another source, verify that it applies to your macOS release, understand what it removes, and keep a record of the original symptom so you can report it accurately if the reset changes nothing.
7. Troubleshooting by symptom
Preview opens the image, but the icon is generic
- Confirm the Finder icon-preview setting is enabled.
- Use the preview pane to see whether Finder can render the selected file.
- Compare another image in the same folder.
- Record the macOS version and file extension if the issue persists.
The preview pane shows the image, but the icon does not
This points to the icon-preview or thumbnail-generation path rather than basic file readability. Keep the investigation focused there; do not infer that the image is corrupt.
Neither Preview nor Finder can show the image
The reviewed sources do not establish the reason a specific file fails to open. Check that you selected the intended file, preserve the original, and seek app or Apple Support guidance appropriate to your macOS version. A missing Finder thumbnail alone is not enough evidence to diagnose file damage.
Only one extension or group of files is affected
Record the extension and macOS version, then test a second file of the same type and a known-good image of another type. Treat the result as evidence for escalation, not as a definitive compatibility claim.
The issue started after a macOS update
Capture the before-and-after details: macOS version, affected extensions, whether Preview opens the files, and whether the preview pane works. This gives Apple Support a reproducible report without guessing at an internal cache or service.
8. Reliability and workflow notes
- Keep an original copy of any image before converting or rewriting metadata.
- Use Preview and the Finder preview pane as separate checks.
- Test a small representative set before changing a whole folder.
- When escalating, include the exact macOS version, file extension, storage location, and the results of both preview tests.
These steps avoid unnecessary file conversion and make it clear whether the failure is limited to icon thumbnails, affects Finder previews generally, or prevents the file from opening at all.
9. Or skip the browser setup
If your real task is producing dependable previews of web pages for a development workflow, you can use ScreenshotNeo instead of maintaining browser automation. It accepts one GET request and returns a PNG, JPEG, WebP, or PDF. Cookie banners, newsletter popups, and chat widgets are removed before capture. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and the response identifies the result with X-Page-Verdict and X-Billed headers. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients.
See the ScreenshotNeo API documentation for all options.
cURL
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)Node.js
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);The Free plan includes 1,000 screenshots per month with no card. Paid plans start at $5 for 3,000 shots, and every feature is included on every plan. Create a free ScreenshotNeo account.
10. FAQ
Does a generic icon mean my image is corrupted?
No. Open it in Preview first. A generic Finder icon can occur even when Preview can read the file.
Why check the preview pane?
The pane and the small icon use different Finder display paths, so the comparison narrows the symptom.
Should I delete Quick Look caches?
Do not assume a cache command is a universal still-image fix. The cited third-party cache guidance is scoped to non-native video support, not a verified Apple repair for still images.
What information should I provide when asking for help?
Include your macOS version, the file extension, whether Preview opens the image, whether Finder’s preview pane shows it, and whether one or many files are affected.
