The has_post_thumbnail() WordPress function

Within your WordPress themes or plugins, you may need to determine if a post has a featured image attached to it. Using the has_post_thumbnail() function, you will be able to easily identify if a post has a featured image or not. In this article, we will show you how to use the has_post_thumbnail() WordPress function.

Basic usage

<?php has_post_thumbnail( $post_id ); ?>

Optional parameters

$post_id: You may optionally define the ID of the post that you are checking for a featured image on. If left undefined, it defaults to the current post being processed.


if ( has_post_thumbnail() ) {
// Do something
else {
// Do something else

In this example, we call the has_post_thumbnail() function within a PHP if statement that will allow us to perform an action if there is a featured image, and another if there is not one.


For more information on the has_post_thumbnail() function, you may review the has_post_thumbnail() WordPress Codex page.

Was this article helpful? Let us know!