How to Fix Featured Image Issues in WP
Last updated: July 2026
If you have ever published a post only to find the thumbnail missing from your blog grid, you already know how frustrating it is to fix featured image not showing WordPress problems. The image looks fine in the media library, it is attached to the post, and yet nothing renders on the front end. At Canada Create we see this ticket land in our inbox every week, usually right after a theme update or a migration.
This guide walks through the most common causes in the order we actually check them when a client site breaks, plus the exact settings to look at inside the WordPress dashboard.
Quick Answer
In most cases, a featured image not displaying WordPress issue is caused by the active theme not calling the_post_thumbnail() in its template files, or by a caching plugin serving a stale version of the page. Clear your cache first, then confirm theme support for post thumbnails, then check for a plugin conflict.
Prerequisites
- Admin access to the WordPress dashboard
- FTP or File Manager access (for theme file checks)
- A recent backup, in case you need to roll back a plugin update
Step 1: Clear Every Layer of Cache
Before touching any code, rule out caching. A page cache, a CDN cache, and your browser cache can all hide a perfectly good wordpress thumbnail not showing fix you already applied.
1a. Purge the page cache plugin
If you use a caching plugin, look for a “Clear Cache” or “Purge All” button in its settings menu and run it.
1b. Purge the CDN
If images are served through a CDN, purge that layer separately. Many hosts bundle their own CDN cache that a plugin-level purge will not touch.
1c. Hard refresh the browser
Use Ctrl+Shift+R (or Cmd+Shift+R on Mac) to bypass local browser cache and confirm the change actually took effect.
Step 2: Confirm Theme Support for Post Thumbnails
Some themes, especially lightweight or heavily customized ones, never register support for featured images in the first place.
2a. Check functions.php
Open your theme’s functions.php file and search for add_theme_support( 'post-thumbnails' ). If it is missing, the theme has no concept of a featured image at all.
2b. Check the template file
Even with theme support declared, the template file for that page (archive.php, single.php, or a block template) needs a call to the_post_thumbnail() or the equivalent Featured Image block. Missing markup is a common cause of a featured image upload error that is really a display error in disguise.
Step 3: Rule Out a Plugin Conflict
Security plugins, lazy-load plugins, and image optimization plugins are the three most common culprits behind a broken thumbnail.
3a. Deactivate lazy-load plugins temporarily
Lazy-loading scripts sometimes strip the src attribute before the browser paints the image. Disable the plugin and reload the page to see if the thumbnail reappears.
3b. Deactivate all plugins, then re-enable one by one
If the image reappears with all plugins off, reactivate them individually until the thumbnail disappears again. That plugin is your conflict.
Step 4: Check the Image File Itself
Sometimes the issue is not code at all, it is the file.
4a. Confirm the file uploaded completely
Open the image URL directly in a new tab. If it does not load, the upload failed or the file was deleted from the server.
4b. Reduce file size
Large uploads, especially PNGs over 5MB, can hit PHP memory limits mid-upload and leave a corrupted or partial file behind. Compress the image and re-upload as JPEG or WebP.
4c. Increase the PHP memory and upload limits
If large images are a recurring problem, ask your host to raise upload_max_filesize and memory_limit in PHP settings.
Step 5: Check File and Folder Permissions
Incorrect permissions on the /wp-content/uploads/ directory can silently block new files from being written or read, even though the media library shows a thumbnail preview.
5a. Set correct permissions
Folders should generally be set to 755 and files to 644. Anything more permissive is a security risk; anything more restrictive can block WordPress from generating image sizes.
Step 6: Regenerate Thumbnails
If the original image displays but the featured image size specifically does not, WordPress may never have generated that image size, often after a theme switch that changed thumbnail dimensions.
6a. Use a thumbnail regeneration tool
A dedicated image-regeneration plugin can rebuild every registered image size from the original upload without you having to re-upload anything manually.
[IMAGE: Before and after screenshot showing a WordPress post grid with a missing thumbnail versus a fixed featured image, related to fix featured image not showing wordpress]
Troubleshooting
| Symptom | Likely Cause | Fix |
|---|---|---|
| Image shows in editor but not on live site | Cache or CDN | Purge all cache layers |
| Image missing across every post | Theme lacks post-thumbnail support | Add theme support in functions.php |
| Image only missing on archive pages | Template file missing thumbnail call | Edit archive.php or block template |
| Image blank after bulk import | Broken attachment ID reference | Reattach or re-upload featured image |
| Image loads slowly then disappears | Lazy-load plugin conflict | Disable lazy load on featured images |
WooCommerce store owners run into a related version of this problem on product pages. If your shop also has trouble with product images or gallery filtering, our guide to the best WooCommerce filter plugins covers how product image handling interacts with filter plugins. We also cover broader platform reliability in our comparison of WP Engine vs Kinsta for managed hosting, since some caching-related image bugs are actually host-level configuration issues.
For sites that migrated recently, stale caching is even more likely. As we cover at Canada Create, a fresh migration is one of the top three causes of this exact bug. If your site is also feeling sluggish since the move, see what actually slows down WordPress on shared hosting for a deeper look at server-side bottlenecks. Canada Create readers who manage multiple client sites often ask whether a full security audit should follow any theme change, and our answer is generally yes, so also check how to secure your WordPress website while you are in the dashboard.
If the fix involves editing template files and you are not comfortable in the theme editor, Canada Create’s Toronto web design team handles this kind of maintenance work directly, and our Yorkville web design service covers ongoing WordPress support for small businesses in that neighborhood too.
According to the official WordPress developer documentation, the_post_thumbnail() must be called within The Loop and will return nothing if no featured image is set or if the theme has not declared support. The WordPress.org support article on child themes is a useful reference if your fix requires overriding a parent theme template safely.
Frequently Asked Questions
Why does my featured image show in the WordPress editor but not on the live site?
This is almost always a caching issue. The editor pulls the image directly from the media library, bypassing any page cache or CDN cache that the public-facing site uses. Clear every cache layer, including your browser, before assuming it is a code problem.
Do I need a plugin to fix a featured image not showing WordPress issue?
No. Most fixes involve checking theme support, cache settings, and file permissions, none of which require installing new software. A regeneration plugin is only needed if WordPress never generated the correct image size.
Can a WordPress update cause featured images to stop showing?
Yes. Core updates occasionally change how image sizes are registered, and theme updates can remove or rename the template calls that render the thumbnail. Always check your site after any update.
Why does the featured image work on some posts but not others?
This pattern usually points to individual posts missing the featured image assignment entirely, or to a specific image file that failed to upload correctly. Open each affected post and confirm the featured image box in the sidebar actually shows a thumbnail.
Is a broken featured image bad for SEO?
Yes, indirectly. Missing thumbnails hurt click-through rate on category pages and in social shares, and broken image references can generate crawl errors. Canada Create treats featured image health as part of standard on-page SEO maintenance.
