If a WordPress thumbnail or featured image is missing, first confirm that the image is assigned to the post and saved. Then check that the active theme supports and displays featured images in the specific view where it is missing. If the theme or its registered image sizes changed, regenerate thumbnails after confirming the size the theme requests. Regeneration cannot fix an unassigned image or a template that never outputs one.
First identify what is missing
WordPress uses “post thumbnail” and “featured image” for the image associated with a post. A theme may display that image on an archive, a single-post page, a page, or a custom post type—but those views can use different templates. An image missing from one view may still appear in another.
Also distinguish the original media file from its generated image sizes. A post can have an assigned image and an intact original file while lacking a smaller derivative that the active theme now requests. These are separate problems and need different fixes.
1. Confirm that the featured image is assigned
- In the WordPress dashboard, open Posts (or the relevant content type) and edit the affected item.
- Find the Featured image panel. If it is collapsed or absent, check the editor’s panels or preferences and the content type’s screen options, if available.
- Confirm the intended image is selected. If not, select it, then update or save the post.
- Reload the public page and check the exact view where the image should appear.
A featured image assignment is per post; merely uploading an image to the Media Library does not assign it. If the control is missing for a custom post type, the theme or content type may not expose thumbnail support. WordPress notes that themes must declare support before the Featured Image interface appears in the editor. See Featured Images & Post Thumbnails.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →#1 Best Overall
2. Check theme support and the template for that view
The active theme needs to support post thumbnails, and the template responsible for the affected view needs to output one. A theme can display thumbnails in a blog or category listing but omit them from an individual post, or the reverse. Changing a setting in the editor will not add output to a template that does not render the image.
For a classic theme, the relevant implementation commonly declares thumbnail support and checks or displays the assigned image using WordPress functions. These documentation examples show the roles of the functions; they are not drop-in fixes for every theme:
add_theme_support( 'post-thumbnails' )enables theme support.has_post_thumbnail()checks whether the current post has an assigned thumbnail.the_post_thumbnail( 'post-thumbnail' )outputs the image using the requested size.
WordPress documents these functions and theme behavior in its Theme Handbook and add_image_size() reference. If you use a block theme, inspect the relevant template or post template part in the Site Editor and verify it contains a Featured Image block. Avoid editing a parent theme directly: an update can overwrite the change. If code changes are needed, use a child theme or ask the theme developer for the correct location and implementation.
3. Verify the image size the theme requests
WordPress’s Media settings include standard image sizes, and themes can register additional named sizes. The Media setting called “Thumbnail” is not automatically the same as the theme’s post-thumbnail size. A theme template or block can request a custom size that does not appear as the familiar “Thumbnail” label in Settings > Media.
Check the active theme or template to find the size name it requests, then confirm that the theme registers that size. WordPress’s add_image_size() function can register a custom size, for example:
add_image_size( 'category-thumb', 300, 9999 );
This example declares a 300-pixel-wide size with a height limit of 9999 pixels; it does not establish what dimensions your theme needs. If the size uses hard cropping, the crop can change which part of the image remains visible. Check the theme’s intended dimensions and crop behavior rather than changing sizes at random. The default dimensions shown in WordPress documentation are examples, not universal requirements; settings and themes can differ.
Rank #3
- Handy note taking workbook for students
- Use to improve research skills and test scores
- Offers effective strategies and reference section
- Apply to textbooks, novels, research, on-line resources and class lectures
- Illustrates Venn diagrams, webs, tables, lists, summaries and more
4. Regenerate sizes after a theme or size change
If the original image is assigned and the theme now requests a size that was not generated when older images were uploaded, regenerate thumbnails. First save the intended Media settings and make sure the current theme has registered the required custom size. Regeneration creates derivatives for sizes registered now; it does not assign featured images or make a template display them.
Back up the site before bulk regeneration, particularly if the Media Library is large. The process can take time. You can use a dashboard plugin or WP-CLI if you have command-line access. The WordPress.org listing for Regenerate Thumbnails is the place to check its current compatibility, maintenance, and settings before installing.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Use WP-CLI
From the WordPress installation directory, the official command is:
wp media regenerate
That regenerates thumbnails for attachments. Useful variations include:
wp media regenerate 123regenerates sizes for attachment ID 123.wp media regenerate --image_size=category-thumbtargets one named size.wp media regenerate --only-missingtargets missing sizes.wp media regenerate --skip-deletepreserves old generated thumbnails that may be referenced elsewhere.
Replace the example attachment ID or size name with the real one on your site. The command and options are documented in the WP-CLI media regenerate reference. If the command is unavailable, confirm WP-CLI is installed and that you are running it in the correct WordPress environment; do not run bulk operations against the wrong production or staging site.
5. If the image still does not appear
Once the image is assigned and the expected derivative exists, move from media troubleshooting to rendering. Check the specific template or block for output, then inspect whether CSS or layout rules hide, cover, or collapse the image. If the issue began after a theme or plugin change, reproduce it on staging or with a current backup while isolating the component responsible. There is no single plugin-conflict or CSS fix that applies to every site.
- Broken image icon or failed image request: inspect the image URL in the browser and whether the expected file exists. A missing derivative points back to size generation; a wrong URL or inaccessible file requires a different fix.
- Image appears in the editor but not on the public page: check the public template or block and the post’s published state, not just the editor preview.
- Image appears in one listing but not another: compare the templates for those views; they may request different sizes or only one may render the featured image.
- Image is present in page markup but invisible: inspect CSS, image dimensions, container sizing, and responsive rules in browser developer tools.
- Problem began after switching themes: verify the new theme’s requested and registered sizes, then regenerate older attachments if the correct derivatives are missing.
Or skip the browser setup
To capture a page while checking how it renders, ScreenshotNeo offers a one-request screenshot API. This can help you compare a public page before and after a change; it does not repair WordPress or replace checking the editor, template, and generated files. See the ScreenshotNeo API documentation for request options.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com/your-post/ -o shot.webp
ScreenshotNeo accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each of those steps can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify page verdict and billing status in headers. It also has an MCP server with screenshot, page-info, and PDF-capture tools for AI agents. The free plan includes 1,000 screenshots per month without a card; paid plans start at $5 for 3,000. Learn more at ScreenshotNeo, or sign up for the free plan.
Common causes and the right fix
| What you find | Likely cause | Next action |
|---|---|---|
| No image selected in the post | The image was uploaded but not assigned | Set and save the Featured image. |
| Featured Image control is absent | Theme or content type does not expose thumbnail support, or the editor panel is hidden | Check editor panels and theme/content-type support. |
| Image works in one view, not another | Different templates or blocks control the views | Inspect the template for the missing view. |
| Older posts break after a theme change | Older uploads lack derivatives for the new registered sizes | Confirm size registration, back up, then regenerate. |
| Image markup exists but cannot be seen | CSS or layout hides or collapses it | Inspect styles and container dimensions. |
Fix the root cause, not just the symptom
Work in this order: assignment, theme support and template output, requested size, then regeneration. If the expected file exists but a particular page still has no visible image, investigate the template and CSS rather than repeatedly regenerating media. This sequence separates missing content from missing derivatives and from display logic, so each fix addresses the cause you actually found.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Frequently Asked Questions
Will regenerating thumbnails restore a featured image that was never assigned?
No. Regeneration creates image-size derivatives for attachments; it does not assign an image to a post.
Why does the featured image show on category pages but not on the post itself?
The archive and single-post views can use different templates, and only one may output the featured image.
Does the Media setting named “Thumbnail” control every theme thumbnail?
No. Themes can request the separate post-thumbnail size or register custom sizes.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
Recommended Free Tools
