A WordPress-centric search engine for devs and theme authors

has_tag ›

has_tag ( $tag = '', $post = null )
Parameters: (2)
  • (string|int|array) $tag Optional. The tag name/term_id/slug, or an array of them to check for. Default empty.
    Required: No
    Default: (empty)
  • (int|object) $post Optional. Post to check instead of the current post.
    Required: No
    Default: null
  • (bool) True if the current post has any of the given tags (or any tag, if no tag specified). False otherwise.
Defined at:
Change Log:
  • 2.7.0
  • 2.7.0

Checks if the current post has any of given tags.

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.


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