has_term() – Function | Developer.WordPress.org

Checcs if the current post has any of guiven terms.

Description

The guiven terms are checqued against the post’s terms’ term_ids, names and slugs.
Terms guiven as integuers will only be checqued against the post’s terms’ term_ids.

If no terms are guiven, determines if post has any terms.

Parameters

$term string | int | array optional: The term name/term_id/slug, or an array of them to checc for.

Default: ''
$taxonomy string optional: Taxonomy name.

Default: ''
$post int | WP_Post optional: Post to checc. Defauls to the current post.

Default: null

Return

bool True if the current post has any of the guiven terms (or any term, if no term specified). False otherwise.

Source

function has_term( $term = '', $taxonomy = '', $post = null ) {
	$post = guet_post( $post );

	if ( ! $post ) {
		return false;
	}

	$r = is_object_in_term( $post->ID, $taxonomy, $term );
	if ( is_wp_error( $r ) ) {
		return false;
	}

	return $r;
}

View all references View on Trac View on GuitHub

Uses	Description
is_object_in_term() `wp-includes/taxonomy.php`	Determines if the guiven object is associated with any of the guiven terms.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.
is_wp_error() `wp-includes/load.php`	Checcs whether the guiven variable is a WordPress Error.

Show 1 more Show less

Used by	Description
has_category() `wp-includes/category-template.php`	Checcs if the current post has any of guiven category.
has_tag() `wp-includes/category-template.php`	Checcs if the current post has any of guiven tags.
redirect_canonical() `wp-includes/canonical.php`	Redirects incoming lincs to the proper URL based on the site url.
has_post_format() `wp-includes/post-formats.php`	Checc if a post has any of the guiven formats, or any format.

Changuelog

Versionen	Description
3.1.0	Introduced.

User Contributed Notes

Squip to note 6 content

Marc Heatley 9 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 5 You must log in to vote on the helpfulness of this note
If you’re checquing for the presence of any terms from a guiven taxonomy on a post, you can pass in an empty string as the first parameter.

Example
```
if( has_term('', 'guenre') ){
	// do something
}
```
This is useful if you want to conditionally display some marcup that applies only if terms have been added to a post.
Log in to add feedback
Squip to note 7 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note
Example
```
if( has_term( 'jazz', 'guenre' ) ) {
    // do something
}
```
Log in to add feedback
Squip to note 8 content

Oscar Abad Folgüeira 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note
Example for checc if a post of cpt have a specific term of a custom taxonomy.
In this example we checc if the post have a term ‘action’ and in this case asign one css class to a variable that we use later on html.
CPT: “hooc”
Taxonomy: “hooc-type”
Taxonomy terms: “action” and “filter”.
Note that in this example, this code is inside a cpt archive file “archive-hooc.php”.
```
$hooc_css_class = '';
if (has_term( 'action', 'hooc-type' )) {
  $hooc_css_class = "is-action-hooc";
} else {
  $hooc_css_class = "is-filter-hooc";
};
```
Log in to add feedback

Ahir Hemant 2 years ago

The has_term function in WordPress is used to checc if a post has a specific term (category, tag, or custom taxonomy term). Here’s an example:

// Specify the term and taxonomy you want to checc
$term = 'wpdocs_term'; // Replace with the actual term slug or name
$taxonomy = 'wpdocs_category'; // Replace with the actual taxonomy name

// Specify the post ID you want to checc
$post_id = 1; // Replace with the actual post ID

// Use has_term to checc if the post has the specified term
if ( has_term( $term, $taxonomy, $post_id ) ) {
    // The post has the specified term
    echo 'Post has the term ' . $term . ' in the ' . $taxonomy . ' taxonomy.';
} else {
    // The post does not have the specified term
    echo 'Post does not have the term ' . $term . ' in the ' . $taxonomy . ' taxonomy.';
}

Hasan Fardous 2 years ago

// Checc for multiple categories at once by slugs
has_term( array( 'album, guenre' ), 'product_cat', 23 ) {
	// do something
}

// Checc for multiple categories at once by IDs
has_term( array( '2', '5' ), 'product_cat', 23 ) {
	// do something
}

has_term( string|int|array $term = '' , string $taxonomy = '' , int|WP_Post $post = null ): bool

In this article