WordPress featured image not showing: symptom, cause and fix
A WordPress featured image usually fails to show for one of four reasons: it isn't set on the post, the theme doesn't display it in that spot, the image has the wrong sizes after a theme change, or the SEO plugin picks a different image for shares. Start with the symptom, meaning where exactly it's missing. That decides where to look for the cause.
Author: The TellMyShop team. A guide for WordPress site and WooCommerce store owners: the cause, the manual fix and the same work in a chat conversation.
Last updated: · 6 min read
Symptom, cause and fix in one table
| Symptom | Most common cause | Fix |
|---|---|---|
| Some posts on the blog page show a grey square or nothing | those posts have no featured image set (old, imported, written in a hurry) | set the image on the post |
| The image is set, but it's missing on the blog page | the theme or archive template doesn't show images | theme settings or the template in the Site Editor |
| There's no Featured image panel in the editor | panel hidden in preferences or no support in the theme | editor preferences, the person who looks after the site |
| Blurry image or a cut-off head | old thumbnail sizes after a theme change | regenerate the thumbnails |
| A Facebook share has no image or a different one | the SEO plugin has another image set, or the site remembers the old version | image in the SEO plugin settings, refresh the preview on the social site |
| A product in the store shows a placeholder | no product image, which is the product's featured image | set the product image |
| An empty frame that never loads where the image should be | a lazy loading, optimisation or CDN plugin | the person who looks after the site |
Below, each symptom in turn. Pick yours and skip the rest.
Posts on the blog page without an image
This is the most common case and the simplest. The post has no image set, so the theme has nothing to show. An image placed in the post content doesn't count. The featured image is a separate field.
These gaps usually appear after importing from another platform, or in old posts written before the theme started showing thumbnails. With a few posts you'll fix them by hand. With 150 posts, just finding the gaps takes a lot of clicking.
By hand, you do it like this:
- Open Posts → All Posts and open a post without an image.
- In the post settings panel on the right, find the Featured image section.
- Choose an image from the Media Library. Ideally one that's already in the post content.
- Check whether the image has alt text and add it if it's missing. Our guide to alt text in WordPress explains how to write it.
- Save the post and check the blog page in a private window.
The image is set, but you can't see it on the page
In that case the theme decides. In block themes, the post list is built by a template in Appearance → Editor. If the archive or blog page template has no Featured Image block, there won't be any images, even though they're set. In classic themes this is controlled by theme options, most often in Appearance → Customize.
Sometimes the theme doesn't support images for a given content type at all. The WordPress documentation on featured images describes this: the theme has to declare support, otherwise the field won't appear in the editor. Adding it means changing theme files, so leave it to the theme author or whoever looks after the site.
Before you ask anyone, check the editor preferences. The three-dot menu in the top right corner of the editor has a Preferences window with a list of panels. The image panel may simply have been switched off.
Blurry or badly cropped thumbnails
When you upload an image, WordPress creates several cropped versions in the sizes set in your settings and by the theme. After a theme change, old images keep the old sizes, and the new theme stretches them or crops them differently. The fix is to regenerate the thumbnails, for example with the Regenerate Thumbnails plugin. On a large library this puts load on the server, so it's better if the person who looks after the site does it.
In future, upload landscape images with the important part in the middle. That way, any crop keeps something of it.
A share with no image or the wrong one
Facebook and LinkedIn take the image from a hidden tag on the page. The SEO plugin writes it, usually in this order: an image set by hand in its fields, then the featured image, then an image from the content. Yoast describes the order and recommended sizes.
If the post has an image but the share shows a different one, check the SEO plugin's social fields on that post. If you changed the image after the first share, the social site may remember the old version. In that case, use the site's own link preview refresh tool.
How the chat finds gaps and sets images in batches
The TellMyShop plugin for WordPress and WooCommerce checks images already in the free TellMyShop Free version. Your chat (Claude or ChatGPT) finds posts, pages and products without a featured image. The site review adds them to the fix plan, alongside other gaps we describe in our post on the WordPress SEO audit. For a single page, the chat also checks whether a share will get an image.
In TellMyShop Pro the chat sets, changes or removes images on up to 50 posts, pages or products at once. It takes the image from the Media Library or uploads it from a public address, up to 15 MB, with alt text and a file name straight away. It doesn't create graphics. It matches images you already have by file name, title and the post the image was uploaded to.
You: Find blog posts without a featured image and suggest images.
Your chat: 23 posts have no image. 17 of them already have a photo in the content, so I suggest using it as the featured image. Example:
Two of these photos have no alt text. I suggest adding it as a separate change, right after this one. 6 posts have no photo at all, so I'll leave those to you.
You: Do those 17.
Your chat: Preview: 17 posts, images from the Media Library, nothing uploaded. Your theme supports images on posts. I'll save it after your ‘yes’.
Pruning roses in autumn
old version: featured image: none
new version: featured image: roses-pruning-secateurs.jpg from the Media Library
Before saving, the preview warns you when the theme doesn't support images for a content type, when an image has no alt text and when a product would be left without a main image. You can undo an image change from the change history, and undoing also removes images uploaded from an address. What the chat won't do: it won't change the archive template, regenerate thumbnails or fix lazy loading. That stays with whoever looks after the site.
You can read more about alt text in Google's image guidelines. The plugin is described on the TellMyShop for WordPress and WooCommerce page, prices are in the pricing, and more guides are on the blog.
Questions and answers
Where do I set the featured image in a WordPress post?
In the post editor, in the post settings panel on the right, under Featured image. You click it, choose an image from the Media Library or upload a new one, and save the post. In a WooCommerce product the same field is called Product image.
Why is there no Featured image panel in the editor?
Either the panel is hidden in the editor preferences, or the theme doesn't support featured images for that content type. Check the editor preferences first and turn the panel on. If it isn't listed there, support has to be added by the theme author or whoever looks after the site.
Does the featured image affect Google?
Indirectly. SEO plugins usually use it as the image for social media shares, and Google considers images on the page for image results. The image alone won't lift your rankings, but a post without one looks worse on the blog page and in shares.
What size should a featured image be?
It depends on the theme, because each one crops images its own way. For shares, Yoast recommends images about 1200 pixels wide. A safe choice is a landscape image with the important part in the middle.
I changed theme and the thumbnails are cropped badly. What now?
WordPress creates cropped versions of an image when you upload it, using the old theme's sizes. The new theme needs different sizes, so they have to be regenerated. The Regenerate Thumbnails plugin does this, or whoever looks after your site can.
WordPress is a trademark of the WordPress Foundation. WooCommerce is a trademark of Automattic Inc. Claude is a trademark of Anthropic PBC. ChatGPT and OpenAI are trademarks of OpenAI. TellMyShop is not affiliated with these companies.