You set a featured image, you publish the post, and then the image is missing from the post page, the blog archive, or the social media preview. This is one of the most frustrating WordPress problems because the image is right there in the editor, yet visitors cannot see it. The good news is that the cause is usually simple: a theme setting, a hidden editor panel, a plugin conflict, or a cache problem.
This checklist walks you through the fixes in the order that solves most cases fastest. Start at the top and test after each step. Do not change five things at once, because you will not know which change fixed the problem, and you may create a new problem while fixing the old one.
First Confirm the Image Is Actually Set
Open the post in the editor and look at the Featured Image panel in the right sidebar. If it says Set featured image, no image is attached yet, even if the post contains images inside the content. Images inside the content do not count as the featured image. Click Set featured image, choose an image from the Media Library or upload a new one, and click Set featured image again to confirm.
Also check that the image file itself is valid. A very large file, an unusual format, or a corrupted upload can fail silently. Try re-uploading the image with a simple filename that uses only letters, numbers, and hyphens, with no spaces or special characters. If the new upload works, the original file was the problem. If you are new to the editor layout, our WordPress dashboard explained for beginners guide shows where the editor panels live.
Check Theme Support and the Post Template
WordPress themes must declare support for featured images, also called post thumbnails. Almost all modern themes do this, but a very old theme, a heavily customized theme, or a custom template may not display the featured image at all. In that case the image is saved correctly, but the template never asks WordPress to show it.
To test this quickly, switch temporarily to a default theme such as Twenty Twenty-Four and view the same post. If the featured image appears with the default theme, your theme or template is the cause. Check the theme settings for a toggle like Show featured image, Display post thumbnail, or Hide featured image on single posts. Many themes hide the image on single posts by design while still showing it on archive pages.
In block themes, the single post template uses a Featured Image block. Open Appearance and then Editor, open the single post template, and confirm the Featured Image block is present where you expect the image. In classic themes, the template calls a function named the_post_thumbnail to print the image. Developers can read the official reference for the_post_thumbnail function to see how that call works. If you are not comfortable editing theme files, contact the theme author or use a child theme rather than editing the parent theme directly.
Check If the Featured Image Panel Is Hidden
In the block editor, panels can be hidden through Preferences. Click the three dot menu in the top right of the editor, open Preferences, go to the Panels section, and make sure Featured image is switched on. If the panel was hidden, you may have been editing posts without realizing the featured image setting was out of sight.
Also check the Document settings sidebar itself. If the sidebar is collapsed, click the gear icon to reopen it and scroll to the Featured Image section. On narrow screens the sidebar can be easy to miss, so widen your browser window or use a larger screen while you troubleshoot. A related layout issue can come from widgets and sidebars, so if your sidebar looks wrong overall, read our guide to WordPress widgets explained for beginners.
Test for Plugin Conflicts in the Right Order
Plugins are a common cause, especially image optimizers, lazy loading plugins, page builders, and plugins that replace the post template or the header. A plugin can hide the image, replace it with a placeholder, load it too late, or strip it from the page output entirely. The reliable way to find the culprit is careful deactivation, one group at a time.
- Deactivate image optimization and lazy loading plugins first, then check the post in a private window.
- Next, deactivate page builder addons and template plugins that control single post layouts.
- Then deactivate other recent plugins, starting with the most recently installed or updated one.
- When the image returns, reactivate the other plugins one by one to confirm which one caused the conflict.
Do this test on a staging site if you can, or during a quiet period if you must test on the live site. Keep a note of what you deactivated so you can restore everything in the same order. If a plugin is essential, look for a setting inside that plugin that controls featured images, lazy loading exclusions, or single post templates before you replace the plugin entirely.
Fix Lazy Loading for Hero and Featured Images
Lazy loading delays image loading until the image is near the viewport. That is good for images lower down a long page, but it can hurt the main featured image at the top of a post. If the featured image is lazy loaded, it may appear late, shift the layout, or fail a speed test that measures the largest visible image. WordPress and many optimization plugins now add lazy loading automatically.
The fix is to exclude the featured image from lazy loading or to mark it as high priority. In many optimization plugins you can add an exclusion by image class, URL, or filename. In code, the featured image should load eagerly rather than lazily when it is the hero image. Check your plugin documentation for its exact exclusion field, because the field name varies. After you change the setting, clear the cache and test the post again, since a cached page can keep serving the old lazy loading markup.
Fix the Wrong Image Size and Regenerate Thumbnails
WordPress creates several sizes of every uploaded image, such as thumbnail, medium, and large, plus sizes defined by your theme. If you uploaded an image before switching themes, the new theme sizes may not exist yet. The post may then request a size that was never generated, and the image can appear broken or missing even though the original file is fine.
First, open the Media Library, click the image, and check its details. Confirm the file URL loads when you open it directly in a browser. If the original loads but the post version does not, a missing size is likely. Install a trusted regenerate thumbnails plugin, run it for the affected images, and then recheck the post. Regeneration creates the missing sizes without changing your content. For official background on how featured images work, see the WordPress documentation on featured images.
Also check the image dimensions your theme expects. A tiny 300 pixel wide image stretched to a full width hero area will look blurry, while an extremely large image can slow the page and trigger optimization rules that replace it. Upload an image at least as wide as your content area, ideally 1200 pixels or wider for a full width header, and let WordPress generate the smaller sizes from it.
Check Upload Errors, Permissions, and the Uploads Folder
If images fail to upload, show as broken icons, or disappear after a site move, check the uploads folder and file permissions. A failed migration can leave image URLs pointing to the old domain, while a permissions problem can block WordPress from writing new thumbnails. Open the image URL directly: a 404 error means the file is not at that address, while a 403 error often points to permissions or a security rule.
Do not change permissions blindly. Uploads folders commonly use 755 for folders and 644 for files, but your host may use different rules, so ask your host support team if you are unsure. If you moved your site recently, search the database for the old domain in image URLs or use a trusted migration plugin to update URLs safely. Reliable hosting prevents many of these file problems, so review your setup in our web hosting guide if upload errors keep returning.
Clear CDN and All Layers of Cache
Caching can keep serving an old version of your post that had no featured image, even after you fixed the real problem. Clear every layer: your browser cache, your caching plugin, your CDN cache, and your host server cache if your host provides one. Then check the post in a private browser window or on a different device.
Social media previews have their own cache too. If the image shows on your site but not when you share the link, the social platform may have cached an old preview from before you set the image. Use the sharing debugger provided by that platform to refresh the preview, and confirm your SEO plugin is set to use the featured image for social sharing. Our guide to adding a table of contents without a plugin also shows how cached markup can hide recent edits, which is a useful parallel when debugging.
Add a Fallback Image When No Featured Image Is Set
A fallback image guarantees that archive pages and social previews never show a blank space, even if an author forgets to set a featured image. You can add a fallback in your child theme template by checking whether the post has a thumbnail, and showing a default image when it does not. Keep the fallback generic, on brand, and sized like your other featured images so archive grids stay consistent.
if ( has_post_thumbnail() ) {
the_post_thumbnail( 'large' );
} else {
echo '<img src="/wp-content/uploads/default-featured.jpg" alt="Default featured image" />';
}Replace the example path with the real URL of your default image after you upload it to the Media Library. Test the fallback on a draft post with no featured image before you rely on it. A fallback is a safety net, not a replacement for setting a proper featured image on every published post.
Frequently Asked Questions
Why is my WordPress featured image not showing on the post page?
The most common reasons are that the image was never set in the Featured Image panel, the theme hides featured images on single posts, or a plugin is blocking it. Confirm the image is set, check the theme settings, test with a default theme, and deactivate optimization plugins one group at a time until the image returns.
Why does the featured image show in the editor but not on the live site?
This usually means the template does not display it, a cache is serving an old version, or a missing thumbnail size is breaking the output. Clear browser, plugin, CDN, and host caches, check the post in a private window, and regenerate thumbnails if you switched themes after uploading the image.
Can a plugin break WordPress featured images?
Yes. Image optimizers, lazy loading tools, page builders, and template plugins can all hide or replace the featured image. Deactivate them in groups, starting with optimizers and lazy loading plugins, and reactivate the others one by one to identify the exact plugin causing the conflict.
How do I fix a featured image that shows on my site but not on social media?
Social platforms cache link previews separately from your site cache. Confirm the featured image loads on the post itself, check that your SEO plugin uses it for social sharing, then use the sharing debugger of that platform to refresh the cached preview for the post URL.
Last updated: October 2026.
