Conditionally display featured image on singular posts and pages


Important notice

If your theme does a customized call to load the featured image (like the Twenty Seventeen theme), this plugin might not work! Use get_the_post_thumbnail() or wp_get_attachment_image() to be sure it will work.


This plugin lets you choose for each post or page, if the featured image should be shown in the single view. This can get handy, if you use the featured image to show a thumbnail on the archives or front page but you don\’t want the featured image to be shown on every posts view itself.

The plugin adds a simple checkbox to the featured image panel (or meta box if you are using the classic editor), that lets you choose, if the featured image will be shown in the singular view or not.


  • Backend
  • Frontend


  1. Upload the plugin files to the /wp-content/plugins/conditional-featured-image directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the Plugins screen in WordPress


The plugin doesn’t work with my theme. What can I do?


  • kindly ask the theme developer to use one of the dedicated WordPress functions (wp_get_attachment_image(), get_the_post_thumbnail(), the_post_thumbnail()) to load the featured image in the singular views.
  • or create a child theme that replaces the call, that loads the featured image, with one of the methods listed above.

Can I hide featured images by default?

Yes. Just add the following line to your functions.php:

add_filter('cybocfi_hide_by_default', '__return_true');

All new posts and pages will now hide the featured image by default (checkbox is checked by default). Existing posts and pages won\’t be changed.

You may also set different default values depending on the post type:

function cybocfi_set_default_hiding_state( $default, $post_type ) {
    if ( 'post' === $post_type ) {
        $default = true; // set the default state for posts
    } else if ( 'page' === $post_type ) {
        $default = false; // set the default state for pages

    return $default;
add_filter( 'cybocfi_hide_by_default', 'cybocfi_set_default_hiding_state', 10, 2 );

Can I limit this plugin to posts (and exclude other post types)?

Yes. By default, the plugin is available on any post type, that has a featured image. But there is a filter, that lets you control, for with post types the plugin should be available. The following example limits it to posts only:

function cybocfi_enable_by_post_type( $post_type ) {
    return 'post' === $post_type;
add_filter( 'cybocfi_post_type', 'cybocfi_enable_by_post_type' );

The filter provides you the current post type and you can decide if you want to use the plugin for this post type by returning true to enable and false to disable it. Add the following snippet to your functions.php to enable the plugin for posts and pages, but disable it for any other post type:

function cybocfi_enable_by_post_type( $post_type ) {
    $allowed_post_types = array( 'post', 'page' ); // add any post type you want to use the plugin with
    return in_array( $post_type, $allowed_post_types );
add_filter( 'cybocfi_post_type', 'cybocfi_enable_by_post_type' );

Is it possible to get the plugin in my language?

Absolutely. You’re invited to contribute a translation in your language. Please keep in mind, that the translation needs to be reviewed by the community, so it will take a little while until it gets accepted.

How can I change the text of the checkbox?

There is a filter hook for this. Add the following snippet to your functions.php:

function cybocfi_set_featured_image_label( $label ) {
    return 'Hide featured image in post'; // change this string
add_filter( 'cibocfi_checkbox_label', 'cybocfi_set_featured_image_label' );


11 octobre 2020
Hi, I've been looking for a solution that works with Woo commerce product pages. When I tick the box to hide featured image on the page, it hides the whole gallery. I'm trying to hide just the featured image. I've tried various code and thought I'd hit the jackpot when I saw this lovely plugin! Can you confirm if the code is doing this intentionally or is there a way to isolate the featured image so that it wont interfere with gallery plugins? I'm not seeing any errors in the console, and when I inspect the page, the entire gallery no longer exists. I would really appreciate your help with this, and it would be great to be able to state it works well for product pages 🙂 many thanks, David
30 setembre 2020
Was looking around that would allow me to feature display images in my blog post listings, but not in the actual blog post itself. I did not need a duplicate featured image stuck in the header of the page. So far, this seems to be one of the few plugins, if not the only plugin that has that capability. Great work and thanks a million for making this available to the WP community!
7 Agost 2020
My template required a featured image displayed in a main-page slider however, I didn't want to display any images in my post, because I already had a YouTube video shows there. This plugin allowed me to hide the image in the post.
26 junh 2020
It took me a while to find a solution to hide singular images from my posts - This Plugin Works absolutely great and is easy to use.
26 març 2020
It works great, but it not only removes the main featured image that is added automatically by wordpress, but also removes/hides the featured image inside any component from the post, such as Single Image from WPBakery Composer. Anyway, I managed to solve it by manually choosing an image from the gallery on that Single Image WPBakery Composer component, instead using the "featured image" option.
Read all 14 reviews

Contributors & Developers

“Conditionally display featured image on singular posts and pages” is open source software. The following people have contributed to this plugin.


“Conditionally display featured image on singular posts and pages” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Conditionally display featured image on singular posts and pages” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Added filter to hide featured images by default
  • Tested up to WordPress 5.5.1
  • Extended FAQ
  • Updated dependencies


  • Tested up to WordPress 5.5 (RC1)
  • Extended FAQ
  • Updated dependencies


  • Allow to enable/disable the plugin by post type


  • Allow filtering the featured image checkbox label
  • Update readme
  • Update dependencies


  • Exclude none essential data from SVN


  • Update dependencies


  • Add support for Yoast SEO (don’t filter image for the social header data)


  • Add support for the block editor (Gutenberg)
  • Tested up to WordPress 5.2.2


  • Makes sure, we do only modify the main post
  • Tested up to WordPress 5.0.0


  • Make it more robust so it will also work with Elementor
  • Tested up to WordPress 4.9.6


  • Tested up to WordPress 4.7.3
  • Tested up to WordPress 4.8.0
  • Tested up to WordPress 4.9.0


  • Tested up to WordPress 4.7.2


  • Get ready for language packs (set text domain equal to the name of the plugins folder, remove load_plugin_textdomain)


  • Tested up to WordPress 4.7.0
  • Removed language folder. Languages are now loaded from


  • Improve plugin title
  • Improve checkbox string
  • Improve documentation
  • Updated stable tag


  • Updated stable tag


  • Extended functionality to pages


  • Initial public release