How to Add a Featured Image in WordPress
Where the setting hides, the Cover-block mix-up, and the image that will not show.
A WordPress featured image is set in one place: the Featured image panel in the editor sidebar. Open the post, find the panel on the right, click Set featured image, pick or upload a file, and publish.
That is the whole answer. The rest is where the panel hides when you cannot find it, why the image sometimes refuses to show, and the one block that gets confused for it constantly.
The featured image is the single picture that represents the whole post. It is not part of the article body. It is the thumbnail your theme prints on the homepage and on archive pages, and the image pulled into the link card when someone shares the post. One image, set once, working in places you never see.
Set the featured image in the block editor
The block editor (Gutenberg) is the default since WordPress 5.0, so this is the path most people are on.
- Open the post or page you want to edit.
- In the right sidebar, click the Post tab (not Block).
- Scroll down to the Featured image panel and click Set featured image.
- Upload a new file or pick one from the media library, then click Set featured image in the bottom corner of that dialog.
- Publish or Update the post.
That is it. The thumbnail now appears wherever your theme decides to show featured images.
Do not see a Featured image panel at all? It got switched off. Click the three-dot Options menu at the top right, open Preferences, and re-enable Featured image under the Panels list. The panel reappears in the sidebar instantly.
Set the featured image in the classic editor
If your site still runs the classic editor, or the Classic Editor plugin, the setting moved but the idea is identical. Look in the lower-right column for a box labeled Featured image and click Set featured image.
Missing that box too? WordPress hides panels you are not using. Click Screen Options at the very top right of the edit screen and tick the Featured image checkbox. The box drops back into the sidebar.
There is a rarer case: some themes never registered support for featured images, so the box does not exist at all. That
is a theme problem, not a you problem - a developer fixes it by adding add_theme_support('post-thumbnails'), and any
modern theme already has it.
The featured image is not the Cover block
This is the mix-up I see most, and it is an easy one to make because both involve a big picture.
A Cover block is something you drop inside the post body. You add it from the block inserter, it sits between your paragraphs, and it is built for a banner with text laid over it - a section break, or a call-out with a tint behind it. You can stack as many Cover blocks as you want in a single article.
A featured image lives outside the body entirely. You never see it in the writing flow. The theme pulls it for the thumbnail and the share card, and a post gets exactly one.
Here is the practical split:
| Featured image | Cover block | |
|---|---|---|
| Where you set it | Sidebar panel | Inside the post body |
| Where it shows | Homepage, archive, social share | Only in the article, where you placed it |
| How many per post | One | As many as you like |
| Main job | Represent the whole post | Decorate a section |
If a picture needs to show up when someone shares your link, it has to be the featured image. A Cover block will never make it onto a social card.
One more cousin to keep straight: there is also a Post Featured Image block, a theme-building tool. It tells a template where to print whatever featured image a post has - you use it inside the site editor when designing a layout. If you are just publishing an article, ignore it. For the full breakdown of featured vs cover vs the social image, I wrote a separate piece on the three of them.
Why the display is theme-dependent
Setting the featured image and seeing it on the page are two different things, and the gap between them is your theme.
WordPress stores the image and hands it to the theme. The theme decides whether to print it at the top of the article, show it only on the homepage grid, crop it to a strip, or skip it entirely on the single post. So “my featured image is not showing” is usually not a broken image - it is attached fine, the theme just does not render it where you expected. Open the post on a default theme like Twenty Twenty-Five to confirm. If it appears there, the behavior is baked into your theme, and the fix lives in the theme’s settings.
The other display gotchas, in rough order of how often they bite:
- A caching or lazy-load plugin is serving an old version or holding the image back. Purge the cache, and exclude featured images from aggressive lazy loading.
- A page-builder template (Elementor, Divi, a block theme template) is overriding the default placement. The image is set; the layout is hiding it.
When it is set but still nowhere on the live post, the full diagnostic - every reason WordPress hides an attached featured image, in the order worth checking - is in why your featured image is not showing in WordPress.
Why the crop looks wrong, and how to fix it
You upload a clean 1200×630 image and the homepage shows it squished, or with your subject’s head sliced off. That is cropping, and it is the most common cosmetic complaint.
Your theme asks WordPress for a specific size - say a square for the archive grid - and WordPress crops your file to fit. The crop is taken from the center by default, so anything important near an edge can get cut. The fix is composition: keep your subject and any text away from the edges so every crop the theme might ask for still works. The pixel targets behind that live in what size a blog cover image should be, but the short version is to design a 1200×630 image that survives a center crop to a square.
If old posts look wrong after you switch themes or change a size, WordPress did not re-cut the images you already uploaded - changing image settings only affects new uploads. Install the free Regenerate Thumbnails plugin and run it once; it re-crops every existing image to your current sizes, and the old crops snap into place.
A quick checklist
Before you call a featured image done:
- Set it in the Featured image sidebar panel, keeping it separate from any Cover block in the body.
- Upload a source file at 1200×630 so social cards stay sharp and most themes never have to upscale.
- Keep the subject and any text away from the edges so center crops survive.
- View the published post and confirm the theme actually shows it where you want.
- After a theme or size change, run Regenerate Thumbnails so old posts re-crop.
None of this is hard once you know the panel is under the Post tab and that your theme is the thing that decides where the image lands. Set it, check it on the live post, and move on.
The part WordPress will not do for you is make the image worth featuring. A good featured image reads as a thumbnail and survives the crop, and that is a design problem to solve before you ever reach the upload step. That is what I built Lede for - drop a sharp one-click export straight into the Featured image panel, working from presets at 1200×630 that keep your subject and title clear of the edges. Open the editor or start from a template in the gallery, then set it and watch it travel.