A WordPress-centric search engine for devs and theme authors

has_tag › WordPress Function

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|WP_Post) $post Optional. Post to check. Defaults to 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 {@link Conditional Tags} article in the Theme Developer Handbook.


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