WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/has tag

Description

Check if the current post has any of the 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.

Note: This function is mask of: has_term( $tag, 'post_tag', $post ) Therefore if you are attempting to determine if a post of a custom post type has a particular tag you need to do: has_term( $tag, 'mycpt_tag', $post )

Usage

<?php has_tag$tag$post ); ?>

Parameters

$tag
(mixed) (optional) The tag name, term_id or slug. Also accepts an array of tag names, term ids and slugs
Default: None
$post
(object) (optional) Post to check instead of the current post.
Default: Current post

Return Values

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

Changelog

Since: 2.6.0

Source File

has_tag() is located in wp-includes/category-template.php.

Related

See also index of Function Reference and index of Template Tags.