has_excerpt() – Function | Developer.WordPress.org

Determines whether the post has a custom excerpt.

Description

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters

$postint|WP_Postoptional: Post ID or WP_Post object. Default is global $post.

Return

bool True if the post has a custom excerpt, false otherwise.

Source

function has_excerpt( $post = 0 ) {
	$post = get_post( $post );
	return ( ! empty( $post->post_excerpt ) );
}

View all references View on Trac View on GitHub

Uses	Description
get_post()`wp-includes/post.php`	Retrieves post data given a post ID or post object.

Used by	Description
WP_Media_List_Table::column_desc()`wp-admin/includes/class-wp-media-list-table.php`	Handles the description column output.

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 5 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
When you need to hide the auto displayed excerpt and only display your post’s excerpts.
```
if ( ! has_excerpt() ) {
	echo '';
} else { 
	the_excerpt();
}
```
Log in to add feedback
Skip to note 6 content

Codex 9 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
Test for presence of excerpt in a post.
```
// Get $post if you're inside a function.
global $post;

if ( has_excerpt( $post->ID ) ) {
	// This post has excerpt.
} else {
	// This post has no excerpt.
}
```
Log in to add feedback
Skip to note 7 content

Arunlal Panja 1 year ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Below code determines whether the post has an excerpt. If excerpt not found, then it will display the first 200 characters for the current post.
```
if ( has_excerpt() ) {
	the_excerpt();
} else { 
	echo substr( get_the_content(), 0, 200 ) . ' ' . __( 'read more..' );
}
```
Log in to add feedback
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: -1You must log in to vote on the helpfulness of this note
Replace auto excerpt with text or code.
```
<?php if ( ! has_excerpt() ) : ?>
	
<?php endif; ?>
```
Log in to add feedback

has_excerpt( int|WP_Post $post ): bool

In this article

Description

Parameters

Return

Source

Changelog

User Contributed Notes

has_excerpt( int|WP_Post $post ): bool

In this article

Description

Parameters

Return

Source

Related

Changelog

User Contributed Notes