How to Set a Featured Image in WordPress
Set a WordPress featured image from the editor, reuse an image block, fix missing controls, and make sure themes display the result correctly.
Direct answer: Open the post or page in the WordPress editor, click the gear icon if the settings sidebar is hidden, choose the Post or Page tab, expand Featured image, click Set featured image, select or upload an image, and confirm. Save or update the post. You can also select an Image block already in the content and choose More options → Set as featured image.
Set a featured image from the post or page settings
- Open the post or page you want to edit.
- Click the gear icon in the upper-right corner to open the settings sidebar if it is hidden.
- Select the tab for the content type: Post, Page, or the label used by your custom post type.
- Expand Featured image, then click Set featured image.
- Choose an existing file in the Media Library or select Upload files to add one.
- Click Set featured image in the media dialog.
- Save a draft, publish, or click Update to persist the change.
After an image is assigned, the panel provides Replace and Remove controls. Removing it leaves the post without a featured image; it does not delete the media file.
WordPress describes this workflow in its Page/Post Settings sidebar documentation.
Use an image that is already in the post
If the image is already inserted as an Image block:
- Select the Image block in the editor.
- Open its More options menu (the three dots).
- Choose Set as featured image.
- Save or update the post.
This assigns the existing media item as the featured image while keeping the Image block in the article. The Image block documentation covers this option and the block’s accessibility settings.
Featured image versus an image in the article
| Item | What it does |
|---|---|
| Featured image | Associates one image with the post, page, or custom post type. The theme decides where it appears. |
| Image block | Places an image at a specific position in the post content. |
| Post Featured Image block | Displays the assigned featured image inside a block-theme template, often in a Query Loop. |
Assigning a featured image does not guarantee that visitors will see it above the article or on the blog index. Themes and templates control placement, crop, link behavior, and dimensions. In a block theme, open the Site Editor and inspect the relevant template for a Post Featured Image block. See the Post Featured Image block documentation.
Choose and prepare the image
- Follow your theme’s image guidance and preview the image in every place it is used. WordPress does not prescribe one universal featured-image size.
- Expect the theme or block settings to crop the source image. A cover-style crop can remove edges; contain-style fitting shows the whole image but may leave empty space.
- Use meaningful alt text when the image conveys information. Mark it decorative when it adds no information or function.
- Alt text entered in the Image block applies to that use. Alt text entered in the Media Library becomes the default when the file is inserted elsewhere.
- Use an image you have permission to publish. WordPress documents Openverse as an optional source when supported by the theme.
For classic themes, developers can register image sizes and choose proportional scaling or hard cropping. The relevant references are Featured Images and Post Thumbnails and set_post_thumbnail_size().
When the Featured image control is missing
The settings sidebar is hidden
Click the gear icon. The sidebar’s content tab controls the whole post or page; the other tab controls the currently selected block.
You are on the wrong tab
Choose the tab labeled Post, Page, or the name of the custom post type. In the Site Editor, Template is a different editing context and does not replace the post settings panel.
A classic theme does not support featured images
Classic themes must declare add_theme_support( 'post-thumbnails' ) for the Featured Image interface to appear. Ask the site administrator or theme developer to add support; do not paste changes into a parent theme that will be overwritten by updates. See the WordPress developer reference.
A plugin or custom post type removed the panel
Check the post type configuration and screen options, then test with a staging copy if a plugin controls editor features. The correct fix depends on that plugin or registration code.
Why the featured image is assigned but not visible
- Check the theme’s single-post, archive, and Query Loop templates for a Post Featured Image block or equivalent template tag.
- Confirm that the image is assigned to the same post you are viewing and that the post was updated after the assignment.
- Inspect block dimensions, aspect ratio, alignment, and link settings.
- Clear page or CDN caches if the editor shows the image but the public page does not.
- Check responsive previews. A theme may show the image on an archive but hide it on the single-post layout.
Crop, sizing, and quality troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Important subject is cut off | Cover crop or a registered hard-crop size | Change the aspect-ratio or fitting setting, edit the source composition, or use a wider image. |
| Image looks blurry | Source is smaller than the rendered size or an aggressive optimization setting | Upload a larger source that matches the theme’s guidance and review image optimization settings. |
| Empty bars appear | Contain-style fitting preserves the whole image | Use a matching aspect ratio or choose a cover treatment if cropping is acceptable. |
| Old image remains visible | Browser, page, or CDN cache | Purge the relevant cache and reload in a private window. |
Or skip the browser setup
If you need a webpage screenshot to use as a WordPress featured image, ScreenshotNeo returns a PNG, JPEG, WebP, or PDF from one GET request. Before capture it accepts consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers identify the page verdict and billing status.
See the ScreenshotNeo API documentation for all options, including full-page capture, viewport and device presets, retina scale, custom CSS and JavaScript, selectors, waiting rules, request blocking, headers, cookies, user agents, geolocation, caching, signed links, asynchronous jobs, webhooks, bulk capture, and usage data.
cURL
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o featured.webpPython
import requests
r = requests.get(
"https://api.screenshotneo.com/v1/shot",
params={"access_key": "YOUR_API_KEY", "url": "https://example.com"},
timeout=90,
)
r.raise_for_status()
open("featured.webp", "wb").write(r.content)Node.js
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://example.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`Screenshot failed: ${res.status}`);
const data = Buffer.from(await res.arrayBuffer());
require('fs').writeFileSync('featured.webp', data);ScreenshotNeo also provides an MCP server with take_screenshot, get_page_info, and capture_pdf tools for Claude, Cursor, and other MCP clients. The Free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots. Only clean shots are billed, which helps when a source page fails or presents a bot check. Create a free ScreenshotNeo account.
Performance, reliability, and cost notes
- For WordPress itself, the featured-image assignment is stored with the post; delivery speed depends on the image file, optimization layer, theme, and cache.
- Generate appropriately sized source images and let WordPress or your optimization/CDN layer serve responsive variants.
- When generating screenshots, wait for a selector, a delay, or network idle when the page renders asynchronously. Use caching with a TTL when the source does not change often.
- Check
X-Page-VerdictandX-Billedheaders in automated jobs so failed captures can be retried or investigated without guessing. - Bulk capture supports up to 100 URLs per call; asynchronous jobs and signed webhooks help keep large imports out of a request timeout.
FAQ
Can I use the same image in the post and as its featured image?
Yes. Select the Image block and choose More options → Set as featured image, or choose the file from the Featured image panel.
Does WordPress automatically show a featured image?
No. The theme or template must render it. Block themes commonly use the Post Featured Image block.
Can a page have a featured image?
Yes, if the page post type and theme support it. The control appears under the Page tab when enabled.
Will changing the featured image change the image inside my article?
No. The featured-image association and an Image block are separate. Changing one does not replace the other.
What should I do if the image is visible in the editor but not publicly?
Inspect the template, confirm the post was updated, and clear page or CDN caches. Also check whether the theme hides the image at a particular breakpoint.
