October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk10 min

WordPress Featured Image Not Showing: Causes and Fixes

A WordPress featured image may be missing because the editor lacks support, the template does not render it, a thumbnail derivative is absent, CSS hides it, or caches and optimization serve stale output. This step-by-step guide shows how to locate and fix each failure.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When a WordPress featured image is missing, the image file is usually not the problem. The failure is normally in one of six places: the editor does not support featured images, the image was assigned to a different post, the active template never renders it, WordPress did not create the thumbnail size the template requests, CSS hides or crops it, or a cache serves an old or altered response.

Use the diagnostic order below. Start in the editor, then check the template, generated files, browser markup, CSS, caches, and finally theme or plugin conflicts. This approach fixes the immediate post without unnecessarily changing the whole site.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

First, identify where the failure occurs

There are two very different symptoms:

  • The Featured Image control is missing in the editor. This is an editor-support or post-type problem.
  • The control is present and an image is selected, but the live page has no image. This is usually a template, thumbnail, CSS, loading, cache, or conflict problem.

Open the affected post or page and confirm that the image is assigned in the Post settings, not merely inserted into the content. Save or update the post, then test the public URL in a private browser window. If the image appears there, the original browser or a cache was showing stale content.

When the Featured Image panel is missing

Check Screen Options first

In the classic editor, open Screen Options at the top right and enable Featured Image if it is unchecked. In the block editor, open the settings sidebar with the gear icon and select the Post tab. A collapsed or hidden panel can look like a missing feature.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Confirm theme support

A theme must declare support for featured images before WordPress adds the Featured Image interface to an edit screen. For a classic theme, the declaration is commonly placed in functions.php:

add_theme_support( 'post-thumbnails' );

Add the declaration on the active theme, not an inactive theme. A child theme can inherit the parent’s support, but a custom or recently switched theme may not declare it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Confirm the post type supports it

Featured images are enabled per post type. Posts may support them while pages or a custom post type does not. When registering a custom post type, include thumbnail in its supports array:

register_post_type( 'portfolio', array(
    'supports' => array( 'title', 'editor', 'thumbnail' ),
) );

If a plugin or custom code registers the post type, change that registration rather than adding unrelated template code. After changing support, reload the editor and verify the Post settings sidebar again.

Block themes use a different editing model

In a block theme, go to Appearance → Editor. The theme can expose featured-image controls through its templates and the Post Featured Image block. If the block is absent from the relevant template, selecting an image on a post will not automatically place it on the page. The editor control and the front-end display are separate decisions.

When an image is selected but does not appear on the site

Inspect the template used by that URL

WordPress does not force every theme, archive, homepage, or single-post layout to display a selected featured image. The active template decides whether it is rendered. A single-post template may show it while an archive card or homepage does not, or the reverse.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

For a block theme, open Appearance → Editor → Templates and inspect the template actually used by the failing URL:

  • Single or a post-type-specific single template for an individual post.
  • Archive for category, tag, date, or custom archives.
  • Home or the posts index for a blog listing.
  • A custom template assigned to the page or post.

Look for a Post Featured Image block. Select it and check its visibility, dimensions, aspect ratio, and linked-post settings. Save the template after making the change; editing the post alone does not modify a site template.

Classic and hybrid themes normally render the image in PHP, often with the_post_thumbnail(), or expose a switch under Appearance → Customize or a theme-specific options panel. Check those settings for separate controls such as “show on single posts,” “show on archives,” “display header image,” or “hide featured image.” Labels vary by theme, so inspect the template or theme documentation when a switch is not obvious.

Verify that the image belongs to the intended post

Open the post’s editor, select the Post tab, and note the thumbnail shown under Featured image. Do not assume that an image inserted into the content, an image in the media library, or an image used as a site logo is also the post’s featured image. On a custom post type, confirm you edited the same record whose public URL you are testing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How WordPress creates the image file a theme requests

Uploading an original image does not create just one browser file. WordPress normally generates several derivatives:

WordPress size Default setting What the value means
Thumbnail 150 × 150 px maximum Configured as a small square-style size; cropping behavior depends on the setting.
Medium 300 × 300 px maximum WordPress constrains the image to these maximum dimensions while preserving its ratio unless a crop is configured.
Medium-large 768 px maximum width WordPress uses the width limit and calculates the height from the image ratio.
Large 1024 × 1024 px maximum WordPress constrains both maximum dimensions while preserving the ratio unless a crop is configured.
Full Size Original resolution The uploaded file at its original dimensions, subject to any processing or upload limits.

The active theme or plugin can register additional sizes with add_image_size() and request one with the_post_thumbnail(). For example:

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
add_image_size( 'card-wide', 640, 360, true );

the_post_thumbnail( 'card-wide' );

The fourth argument, true, requests hard cropping to the specified dimensions. A theme can therefore produce a blank-looking card, a broken image URL, or an unexpectedly cropped image even though the original upload is valid.

Regenerate derivatives after size changes

If the theme added or changed a size after the image was uploaded, old media items may not have that file. Install a reputable thumbnail-regeneration tool, run it for the affected media, and verify the requested size exists. Regeneration changes media derivatives across the site; it does not change the original upload or automatically alter the template.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Before regenerating a large library, check available storage and run a small batch. If only one post is affected, regenerate that attachment first and test it before processing everything.

Use the browser to distinguish a missing file from a hidden image

Developer tools can show exactly what the page received. Open the public page, right-click the affected area, choose Inspect, and search the Elements panel for an <img> element.

If no image element exists

No <img> means the active template or block layout did not render the featured image. Recheck the template, the block’s visibility, and any theme option that controls featured-image output. A CSS fix cannot restore markup that was never generated.

If an image element exists

Record its src and srcset values. Open the src URL in a new tab and check the browser Network panel:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
  • 200 response and an image opens: the file exists; inspect computed CSS and layout.
  • 404 response: the template requested a missing derivative or an obsolete URL. Regenerate the required size, correct the media URL, or remove the stale cache.
  • 403 or other access error: a security, permissions, hotlink, or CDN rule may be blocking the file.
  • Unexpected domain or path: an optimization or CDN layer may be rewriting the URL incorrectly.

In the Computed styles panel, check display, visibility, opacity, width, height, overflow, and positioning. A loaded image with zero dimensions, display: none, a clipped parent, or an opaque overlay can appear to be missing.

Fix aspect ratio, dimensions, and cropping problems

The Post Featured Image block has controls for aspect ratio, height, and width. A fixed height combined with an unsuitable ratio can crop a subject out of view; an overly restrictive width can reduce the image to an apparently empty sliver. In the Site Editor, select the block and review those controls before editing CSS.

Common CSS causes include:

  • width: 0 or height: 0 inherited from a layout rule.
  • display: none, visibility: hidden, or very low opacity.
  • overflow: hidden on a short container that clips the image.
  • A fixed frame with object-fit: cover that removes the important part of the photograph.
  • A selector that targets every image inside a card and unintentionally hides the featured image.

Use a narrow, scoped rule rather than changing every image globally. For example:

.single-post .wp-block-post-featured-image img {
    display: block;
    width: 100%;
    height: auto;
}

Replace the selector with the class used by your theme. If the design requires a fixed card frame, set an intentional aspect ratio and use object-fit: cover only when cropping is acceptable. Remove the rule or revert the Customizer change if it affects unrelated templates.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Account for lazy loading and cache layers

Lazy loading is normally expected

Since WordPress 5.5, images rendered through core paths such as wp_get_attachment_image() are lazy-loaded by default. The browser may defer an image until it approaches the viewport. A slow or over-aggressive optimization script can make a valid image appear late, replace its URL, or fail to restore it.

Scroll the image into view and watch the Network panel. If the request starts only after scrolling, lazy loading is working rather than proving that the image is absent. If an optimization plugin has rewritten the markup, temporarily disable only its lazy-load or image-rewrite feature and retest.

Clear every relevant cache

After changing a template, image size, CSS rule, or optimization setting, stale output can remain at several layers:

  1. Save or update the post or template.
  2. Purge the WordPress caching or optimization plugin.
  3. Purge any hosting page cache.
  4. Purge the CDN cache if one is in use.
  5. Hard-refresh the browser, then test in a private window.

Compare the page source before relying on the visual result. If the source still contains an old image URL after a purge, another cache or server-side page layer is serving the old HTML.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Isolate theme and plugin conflicts safely

If the image exists, the template is correct, derivatives are present, and caches are clear, test for a conflict. Make a backup and, where possible, use a staging site. On the live site, schedule the test for a low-traffic period and avoid leaving security or caching components disabled.

  1. Record the affected URL, post type, active template, selected image, image URL, and current cache settings.
  2. Temporarily switch to a current default WordPress theme. Check the same post and archive.
  3. If the image appears, the original theme, its template, or its CSS is responsible. If it remains missing, continue.
  4. Deactivate nonessential plugins, especially page builders, image optimizers, lazy-load tools, CDN connectors, and access-control plugins.
  5. Reactivate plugins one at a time, checking the page after each activation.
  6. When the problem returns, inspect that component’s settings and its generated markup, then restore the other plugins.

A default-theme test changes site presentation, so it is a diagnostic step, not a permanent fix. Keep a record of which component changed the result so you can reverse the test without guessing.

Choose the least disruptive fix

Where the failure is found Typical fix Skill level Scope and risk
Editor panel or Screen Options Enable the panel and confirm post-type support. Settings Usually one editor screen; low risk.
Theme or block template Add or enable the Post Featured Image block, or correct the theme template. Settings to code Can affect every post using that template.
Missing derivative Regenerate thumbnails or correct the requested size. Settings Changes media derivatives; storage and processing are considerations.
CSS or block dimensions Remove the hiding rule and set deliberate width, height, ratio, and crop behavior. Settings to CSS May alter many cards or posts if the selector is broad.
Lazy loading or optimization Correct the rewrite or disable only the faulty feature. Settings Can affect performance and every optimized image.
Cache Purge plugin, host, CDN, and browser caches in that order. Settings Low code risk; visitors may briefly receive uncached pages.
Theme or plugin conflict Reactivate components one by one and repair the offending setting or code. Intermediate Potentially site-wide; use staging or a maintenance window.

A complete troubleshooting sequence

Follow this checklist without skipping ahead:

  1. Open the intended post and verify the selected image under Post → Featured image.
  2. Enable the panel through Screen Options or the editor settings sidebar if it is hidden.
  3. Confirm the active theme declares post-thumbnails and that the post type supports thumbnail.
  4. For a block theme, inspect Appearance → Editor → Templates and add or configure the Post Featured Image block in the template used by the failing URL.
  5. For a classic or hybrid theme, check Appearance → Customize and theme options, then inspect the single, archive, or homepage template.
  6. Inspect the rendered page for an <img>, its src, and its srcset.
  7. Test the requested URL for a 200 response, then check for 404s, access errors, wrong paths, or a missing derivative.
  8. Regenerate thumbnails if the theme’s requested size was added or changed after upload.
  9. Check computed CSS and block dimensions for zero size, hidden display, clipping, unsuitable aspect ratio, and unwanted cropping.
  10. Scroll the image into view to test lazy loading, then temporarily isolate image optimization if the request is rewritten or never starts.
  11. Purge plugin, host, CDN, and browser caches; retest in a private window.
  12. Use a default theme and one-by-one plugin reactivation to identify a remaining conflict.

Prevent future featured-image failures

  • Keep featured-image support enabled deliberately for every post type that needs it.
  • Document which templates display images on single posts, archives, search results, and the homepage.
  • Use consistent registered image sizes and regenerate derivatives after changing them.
  • Review block aspect-ratio and crop settings at the same time you change a layout.
  • After template or optimization changes, test one single post, one archive, and one mobile viewport.
  • Keep a cache-purge procedure for the WordPress plugin, host, CDN, and browser layers.
  • Record the original theme, plugin, template, and image URL before disabling anything during conflict testing.

The Bottom Line

A featured image can be selected correctly and still remain invisible because WordPress separates image assignment from image rendering. Check editor support, the active template, generated thumbnail files, rendered markup, CSS, loading behavior, caches, and conflicts in that order; the first layer that fails identifies the appropriate fix.

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.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.