has_tag() – Function | Developer.WordPress.org

Checks if the current post has any of given tags.

Description

The given tags are checked against the post’s tags’ term_ids, names and slugs.
Tags given as integers will only be checked against the post’s tags’ term_ids.

If no tags are given, determines if post has any tags.

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

Parameters

$tagstring|int|arrayoptional: The tag name/term_id/slug, or an array of them to check for.
Default:''
$postint|WP_Postoptional: Post to check. Defaults to the current post.
Default:null

Return

bool True if the current post has any of the given tags (or any tag, if no tag specified). False otherwise.

Source

function has_tag( $tag = '', $post = null ) {
	return has_term( $tag, 'post_tag', $post );
}

View all references View on Trac View on GitHub

Changelog

Version	Description
2.7.0	Can be used outside of the WordPress Loop if `$post` is provided.
2.6.0	Introduced.

User Contributed Notes

Skip to note 3 content

Andrea Castenetto 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
If the article has tags, show them. Else do nothing. It works in the loop.
```
if(has_tag()) {
    the_tags();
} else {
    //Article untagged
}
```
Log in to add feedback
Skip to note 4 content

Andrea Castenetto 9 years 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
If Post has tag, show them. Else if Post has category, show category. Otherwise do other.
```
if(has_tag()) {

      the_tags(); //show tags

} elseif(has_category()) {

      the_category(); //show category

} else {
      //do something different
}
```
Log in to add feedback

has_tag( string|int|array $tag = '', int|WP_Post $post = null ): bool

In this article