has_tag( string|int|array $tag = '', int|object $post = null )

Checks if the current post has any of given tags.


Description 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.


Top ↑

Parameters Parameters

$tag

(string|int|array) (Optional) The tag name/term_id/slug, or an array of them to check for.

Default value: ''

$post

(int|object) (Optional) Post to check instead of the current post.

Default value: null


Top ↑

Return Return

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


Top ↑

Source Source

File: wp-includes/category-template.php

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


Top ↑

Changelog Changelog

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

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.