has_post_thumbnail( int|WP_Post $post = null ): bool

User Contributed Notes

1. Skip to note 6 content

   Webmaster 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 9You must log in to vote on the helpfulness of this note

   It’s worth noting that has_post_thumbnail() does not just check for the Featured Image as the Codex User Contributed Note suggests. If a post contains no defined featured image but it does contain an image in the content this function will still return TRUE.
2. Skip to note 7 content

   Phil McDonnell 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

   @Matt Stone, I don’t agree with you. Just tested this:

   <?php if (has_post_thumbnail( $post->ID ) ): ?>

   and it is only showing me true if I do in fact have a featured image. If I don’t have one, even with images in the content it returns false…
3. Skip to note 8 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   This example first checks if there is a Post Thumbnail (aka Featured Image) set for the current queried item. If there is a Post Thumbnail set, it returns the Post Thumbnail. If not, it echoes out a default image which should be located in the current theme’s image folder (assuming the folder is in the theme’s root directory).

   <?php
   // Must be inside a loop.
   
   if ( has_post_thumbnail() ) {
   	the_post_thumbnail();
   }
   else {
   	echo '<img src="' . get_bloginfo( 'stylesheet_directory' ) 
   		. '/images/thumbnail-default.jpg" />';
   }
   ?>

   You can use set_post_thumbnail_size() to set a default size for your thumbnail. Alternatively, you can add new image sizes to the defaults by use add_image_size().

   • if ( has_post_thumbnail() ) { the_post_thumbnail( 'post-thumbnails', array( 'class' => 'h-full w-full', 'title' => 'Pantera' ) ); } else { echo ''; }

     Pantera Negra 4 years ago
4. Skip to note 9 content

   David Elstob 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   <?php 
   if ( has_post_thumbnail() ) {
       $attachment_image = wp_get_attachment_url( get_post_thumbnail_id() );
       echo '<link rel="preload" as="image" href="' . esc_attr( $attachment_image ) . '">';	
   } ?>

   This checks to see if there is an active thumbnail and preloads the image. Place code in the head section of header.php and it will save adding long arrays. It should also help with overcoming the Core Web Vitals LCP metric.
5. Skip to note 10 content

   jakeparrotta 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   if ( has_post_thumbnail() ) {     
       echo '<div style='background-image: url(' . get_the_post_thumbnail_url() . ');></div>';
   }
   ?>

   This if statement checks to see if there is a thumbnail in the post. If not, nothing will display.

   Use case: A hand-coded loop of posts where some have featured images and some don’t and you don’t want an empty background for that div.