Why HEIC File Thumbnails Are Not Showing and How to Fix Them

Windows cannot show a HEIC thumbnail when its HEIF thumbnail codec is missing, damaged, unregistered, or unable to decode that particular file. HEIC is a HEIF image file, commonly compressed with HEVC. Install or repair both HEIF Image Extensions and HEVC Video Extensions, restart Photos and Windows, then test a file copied to a local folder. If Photos opens the image but Explorer still shows a generic icon, troubleshoot thumbnail settings, Explorer state, cloud placeholders, and codec registration separately.

This guide covers Windows File Explorer, Photos, PowerToys thumbnail support, cloud files, damaged images, and conversion fallbacks.

1. Confirm the file and where it is stored

Check the extension. The filename normally ends in .heic; other HEIF extensions may also be used.
Copy one problem file to a local NTFS folder such as Pictures or Desktop.
Wait for the copy to finish, select a medium or large icon view in Explorer, and test the local copy.

A cloud-storage placeholder may not contain the complete image locally. In that case, Explorer may be waiting for the provider to supply a preview instead of generating one on your PC. PowerToys documentation also warns that cloud paths can obtain thumbnails from the cloud rather than creating them locally. If the copied file shows a thumbnail, the codec is probably working and the original problem is synchronization or an online-only placeholder.

2. Install or repair the Microsoft codecs

Microsoft’s documented Photos troubleshooting path is to install both extensions from the Microsoft Store, then restart Photos. The two components cover different parts of the common HEIC path:

Component	Role	What a failure looks like
HEIF Image Extensions	Provides HEIF/HEIC image support	HEIC files cannot be decoded or previewed
HEVC Video Extensions	Provides the HEVC decoder used by many HEIC files	Some files open while others show errors or generic icons

Open the Microsoft Store and search for HEIF Image Extensions.
Install it, or select Repair/Update if that option is available.
Search for HEVC Video Extensions and install or repair it as well.
Close Photos and every File Explorer window.
Restart Windows. This reloads shell extensions and thumbnail providers.
Copy a test file into a local folder and check its thumbnail again.

Microsoft identifies .heic as a common extension for HEVC-compressed HEIF files in its HEIF codec documentation. See Microsoft Support for the Photos troubleshooting guidance and Microsoft Learn for Windows media codec documentation.

3. Check Explorer’s thumbnail setting

Explorer can be configured to hide thumbnails even when the codec works.

Open File Explorer.
Select View and open Options (or Folder Options).
Open the View tab.
Clear Always show icons, never thumbnails.
Apply the change and reopen the folder.

Use a medium, large, or extra-large icon view while testing. Details and list views may not make the preview obvious.

4. Determine whether the codec or Explorer is failing

Open the same local file by double-clicking it.

Photos also fails: the codec is missing or damaged, the file is incomplete, or the image uses an unsupported profile. Return to the codec repair step and test another HEIC file.
Photos opens it but Explorer shows a generic icon: Explorer’s thumbnail setting, cache, shell state, cloud status, or thumbnail-provider registration is more likely.

Windows shell integration depends on a codec implementing IThumbnailProvider and IPropertyStore for the file extension. An extension can appear installed while its registration or dependency is unusable. Restarting Windows after installation is therefore part of the fix, not just a cosmetic step.

5. Refresh Explorer after changing codecs

First close all Explorer windows and reopen them. If that does not help, restart the shell:

Press Ctrl+Shift+Esc to open Task Manager.
Find Windows Explorer.
Right-click it and choose Restart.
Open the local test folder again.

Restart Photos too. Photos and Explorer can retain the old codec state until their processes are restarted.

6. If you use PowerToys

PowerToys can add thumbnail handlers for several file types. Open PowerToys settings and check the relevant File Explorer add-on or thumbnail support. Apply the setting and reboot when PowerToys requests it. Test with one local file before changing more settings.

Do not stack several thumbnail extensions while diagnosing the issue. Multiple handlers can make it unclear which component owns the extension. Disable an optional handler temporarily if Photos works but Explorer remains inconsistent.

7. Handle cloud-only files

OneDrive, iCloud, and other providers can show a filename before the complete file has been downloaded. A cloud icon, an on-demand status, or a file that opens only after a delay indicates that the local machine may not have the bytes needed to decode a thumbnail.

Choose the provider’s option to keep the file on the device or download it.
Wait for synchronization to finish.
Copy the downloaded file to Pictures.
Test that local copy before changing codecs again.

8. Check for a damaged or unusual HEIC file

If only one image fails while other HEIC files preview normally, the file itself may be incomplete or encoded with a profile your installed decoder does not support.

Compare the file size with the original on the phone or camera.
Download or copy it again instead of reusing the existing cloud placeholder.
Test a newly captured HEIC image from the same device.
If every other image works, use a conversion fallback for the affected file.

9. Convert or reimport when decoding still fails

Microsoft documents several supported fallbacks: reimport the media from the device, email it, or use OneDrive conversion. Many devices automatically convert HEIF/HEVC media to a more common format during transfer or email. These approaches produce JPEG or another broadly supported format, but conversion changes the file format and may remove HEIC-specific metadata or compression advantages.

Fix	Restores native HEIC thumbnails?	Scope	Format changes?
Install/repair both codecs	Usually, when the file is valid	Whole PC	No
Download cloud placeholder	Yes, if the codec works	Selected files	No
Restart Explorer or Windows	Repairs stale shell state	Whole shell	No
Reimport, email, or OneDrive conversion	No; creates a different file	Selected files or a batch workflow	Usually

10. Troubleshooting checklist

Symptom	Likely cause	Fix
Every HEIC file has a generic icon	Missing codec or thumbnails disabled	Install/repair HEIF and HEVC; clear “Always show icons, never thumbnails.”
Photos shows an extension error	HEIF or HEVC component unavailable	Install or repair both Microsoft Store extensions and restart Photos.
Photos opens files, Explorer does not	Shell state, cache, or thumbnail-provider registration	Restart Explorer, reboot, check settings, and test a local copy.
Only cloud-folder files fail	Online-only placeholders	Download the file or copy it to a local NTFS folder.
Only a few files fail	Incomplete or unusual files	Recopy them, compare with a known-good HEIC, or convert them.
Thumbnails disappeared after an update	Extension or shell registration changed	Repair both codecs, restart Windows, and recheck Explorer options.
PowerToys previews are inconsistent	Add-on disabled or competing handlers	Enable the relevant support, reboot, and temporarily disable duplicate handlers.

11. Performance, reliability, and storage notes

Thumbnail generation is local work: large HEIC files and folders with thousands of images can take time to populate after installation or a cache refresh.
Cloud synchronization adds another dependency: a fast connection does not help until the complete file is present locally.
Conversion trades compatibility for efficiency: JPEG is easier for older software to read, but it can be larger and may lose HEIC metadata or compression efficiency.
Test with a small sample first: verify one local file, one cloud-downloaded file, and one newly captured file before converting a whole library.
Do not infer codec health from one file: a single damaged image can fail even when the installation is correct.

12. Or skip the browser setup

If you need screenshots of documentation, support pages, or a web-based conversion workflow while recording the fix, ScreenshotNeo provides a single-request screenshot API. It is separate from Windows HEIC decoding: it captures web pages rather than repairing local codecs.

Use the same request from the command line, Python, or Node.js. Full API options are listed in the ScreenshotNeo documentation.

cURL

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://support.microsoft.com/ -o support-page.webp

Python

import requests

r = requests.get(
    "https://api.screenshotneo.com/v1/shot",
    params={"access_key": "YOUR_API_KEY", "url": "https://support.microsoft.com/"},
    timeout=90,
)
r.raise_for_status()
open("support-page.webp", "wb").write(r.content)

Node.js

const q = new URLSearchParams({
  access_key: 'YOUR_API_KEY',
  url: 'https://support.microsoft.com/'
});
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`Screenshot failed: ${res.status}`);
const fs = await import('node:fs/promises');
await fs.writeFile('support-page.webp', Buffer.from(await res.arrayBuffer()));

ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before capture. Bot checks, blank pages, failed loads, timeouts, and cache hits are not billed, and response headers identify the page verdict and billing result. Its MCP server lets Claude, Cursor, and other MCP clients call take_screenshot, get_page_info, and capture_pdf. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots.

Create a free ScreenshotNeo account to try the 1,000-shot monthly allowance.

FAQ

Why do some HEIC files open while others do not?

They may use different HEIF profiles, or one file may be incomplete. HEVC support is also needed for many HEIC files.

Do I need both HEIF and HEVC extensions?

For broad support, yes. Microsoft’s documented fix is to install or repair both extensions and restart Photos.

Will converting HEIC to JPEG repair the original thumbnail provider?

No. It creates a JPEG that uses a different decoder. Repair the codecs if you want native HEIC previews.

Why does copying the file to Desktop help?

It separates codec problems from cloud placeholder problems. A local copy contains the image bytes needed for thumbnail generation.

Can Explorer thumbnails be disabled independently of Photos?

Yes. The Explorer setting to always show icons can hide thumbnails even when Photos opens the file correctly.