Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/has post thumbnail


Returns a boolean if a post has a Featured Image (formerly known as Post Thumbnail) attached (true) or not (false).

Note: To enable featured images / post thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails.


 <?php has_post_thumbnail$post_id ); ?> 


(integer) (optional) Post ID.
Default: 'ID', the post ID.


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).

// Must be inside a loop.

if ( has_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().


Source File

has_post_thumbnail() is located in wp-includes/post-thumbnail-template.php.


Post Thumbnails:

See also index of Function Reference and index of Template Tags.