Blogging & content · Guide
How to Set a Featured Image in WordPress (Posts, Pages and Themes)

Short answer
To set a featured image in WordPress, open the post, select the Post tab in the right sidebar, click Set featured image, then upload a new image or pick one from the Media Library and confirm. Save or update the post. Your theme decides where the featured image appears, such as at the top of the post and on blog archive pages.
Key takeaways
- Featured images are set in the Post tab of the editor sidebar.
- The theme decides where and at what size the image appears.
- Add alt text to the image in the Media Library dialog.
- SEO plugins often use the featured image for social sharing previews.
- If the option is missing, the theme may not support featured images.
What is a featured image in WordPress?
A featured image, also called a post thumbnail, is the main image chosen to represent a post or page, which themes show in places like the post header, blog lists and related posts.
It is separate from images inside the content. Setting a featured image does not add it to the post body.
The WordPress Theme Handbook page on featured images and post thumbnails explains how themes enable and display them.
Most modern themes support featured images on posts, and many support them on pages too.
How do you set a featured image?
Open the post in the editor, select the Post tab in the sidebar, click Set featured image, choose or upload an image in the Media Library, then click Set featured image and update the post.
If you do not see the sidebar, click the settings icon at the top right of the editor.
The featured image panel shows a preview once an image is chosen. Click the preview to replace it later.
Our guide on editing a page in WordPress shows where the sidebar panels are in the editor.
How do you replace or remove a featured image?
In the same panel, click Replace to choose a different image, or Remove to clear it, then update the post to save the change.
Removing the featured image does not delete the file. It stays in the Media Library for other posts.
Can you set a featured image from the posts list?
Not in core WordPress; the posts list only offers Quick Edit for titles, dates and categories, so open each post to set its image, or use a plugin that adds a featured image column.
For many posts, a plugin with a column view saves a lot of clicking.
How do you set a featured image in the classic editor?
In the classic editor, find the Featured image box in the right column under the Publish box, click Set featured image, choose the image and update the post.
If the box is missing, open Screen Options at the top of the screen and tick Featured image.
What size should a featured image be?
There is no single correct size; use the size your theme recommends, and a wide image of at least 1,200 pixels works well for most themes, social previews and Google Discover.
Google's Discover guidelines recommend large images at least 1,200 pixels wide for content that may appear in Discover.
Check your theme's documentation for its preferred aspect ratio. Some crop images to a wide banner, others to a square.
Keep important details near the centre. Themes and social networks often crop the edges.
Pick one aspect ratio for the whole blog, such as 16:9. Consistent shapes keep archive grids neat and make it easier to prepare images quickly.
How do you add alt text to a featured image?
In the Media Library dialog, select the image and fill in the Alternative Text field before clicking Set featured image; you can also edit it later in Media > Library.
Alt text describes the image for screen readers and when images fail to load.
MDN's reference for the img element explains how alt text is used.
Write a short, accurate description. Skip phrases like image of, and do not stuff keywords.
Describe what matters for the post. A featured image of a laptop on a desk could be described by what the laptop screen shows, if that is the point of the article.
Where does the featured image appear?
The theme controls placement: commonly at the top of single posts, on the blog page and archives, in related posts, and in some widgets or blocks.
In block themes, the Post Featured Image block inside templates decides where it shows. Edit the template in the Site Editor to move or remove it.
In classic themes, theme options or the Customizer sometimes control whether featured images display on single posts.
If the image appears twice, it may be set as the featured image and also inserted in the content. Remove one of them.
Why is there no featured image option?
The option is missing when the theme does not declare featured image support, when the panel is hidden in editor preferences, or when a custom post type does not support thumbnails.
Check the editor preferences under the Panels section and turn the Featured image panel on.
Developers enable support with add_theme_support for post thumbnails in the theme's functions file.
For custom post types, the post type must include thumbnail support when it is registered.
Do image sizes regenerate when you change themes?
Not automatically. WordPress creates image sizes when you upload, so after switching themes, older images may lack the new theme's sizes until you regenerate thumbnails with a plugin or WP-CLI.
This explains stretched or oddly cropped images right after a theme change.
Why is the featured image not showing?
The theme may not display it on that template, a page builder layout may hide it, caching may serve an old version, or the image may be too small for the theme's crop.
Clear your cache and view the post logged out. Then compare it with another post where the featured image does appear, to see whether the problem affects one post or all of them.
Check the template in the Site Editor, or your theme options, for a setting that hides featured images.
If the image looks blurry, upload a larger version. Themes stretch small images to fill their layout.
How does the featured image affect social sharing?
SEO and social plugins usually use the featured image as the Open Graph image, which Facebook, LinkedIn and messaging apps show when someone shares your link.
The Open Graph protocol defines the og:image tag these previews use.
Our guide on adding Open Graph tags in WordPress shows how to set custom social images.
If a share preview shows the wrong image, update the post, then refresh the platform's preview cache with its debugging tool.
How do you optimise featured images for speed?
Compress images before uploading, use modern formats such as WebP where supported, and let WordPress generate responsive sizes so phones download smaller files.
Featured images are often the largest element at the top of a post, which affects loading metrics.
The web.dev guide to choosing image formats explains the trade-offs between JPEG, PNG and WebP.
Our guide on optimizing images for SEO covers file names, compression and lazy loading.
Can you set featured images automatically?
Yes, with plugins that use the first image in a post or a default fallback image, which helps when importing many old posts without featured images.
A default image keeps archive layouts tidy. It is better to choose real images for important posts, though, because a generic image tells readers little about the article.
For bulk changes, test on a few posts first. Some plugins change images on every post at once.
Do pages and custom post types need featured images?
Not always; pages often use custom headers instead, but featured images help when pages appear in lists, search results inside your site or social shares.
Products in WooCommerce use the featured image as the main product image.
Extra product photos go into the product gallery, which sits just below the main image setting in the product editor.
Set one for any content that will be shared or listed, even if the theme hides it on the page itself.
What makes a good featured image?
A good featured image is clear at small sizes, relevant to the post, consistent in style with the rest of the blog, and leaves room for theme or social crops.
Avoid tiny text inside images. It becomes unreadable in archive thumbnails.
Use original photos or graphics where possible. Readers recognise generic stock photos quickly.
Create a simple template for your featured images, with the same fonts and colors each time. It gives your blog a recognisable look in feeds and search results.
Frequently asked questions
Where is the featured image option in WordPress?
Open the post, select the Post tab in the right sidebar and find the Featured image panel. Click Set featured image to choose or upload an image.
What is the best featured image size for WordPress?
Use the size your theme recommends. A wide image at least 1,200 pixels across works well for most themes, social previews and Google Discover.
Why is my featured image not showing?
The theme or template may not display it, a page builder may hide it, caching may show an old version, or the image may be too small for the theme's layout.
Does a featured image show on social media?
Usually yes. SEO and social plugins use the featured image as the Open Graph image unless you set a custom social image for the post.
Can I add a featured image to pages?
Yes, if your theme supports featured images on pages. The same Featured image panel appears in the page settings sidebar.
Sources
- Featured Images and Post Thumbnails WordPress Theme Handbook
- Google Discover Google Search Central
- The Open Graph protocol ogp.me
- The Image Embed element MDN Web Docs
- Choose the right image format web.dev
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


