category_exists() – Function | Developer.WordPress.org

Checks whether a category exists.

Description

Parameters

$cat_nameint|stringrequired: Category name.
$category_parentintoptional: ID of parent category.
Default:null

Return

string|null Returns the category ID as a numeric string if the pairing exists, null if not.

Source

function category_exists( $cat_name, $category_parent = null ) {
	$id = term_exists( $cat_name, 'category', $category_parent );
	if ( is_array( $id ) ) {
		$id = $id['term_id'];
	}
	return $id;
}

View all references View on Trac View on GitHub

Uses	Description
term_exists()`wp-includes/taxonomy.php`	Determines whether a taxonomy term exists.

Used by	Description
wp_create_category()`wp-admin/includes/taxonomy.php`	Adds a new category to the database if it does not already exist.
wp_create_categories()`wp-admin/includes/taxonomy.php`	Creates categories for the given post.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

keesiemeijer 7 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

Beware this function is only available in the wp-admin and will throw an error if used in the front end of your site. Use term_exists instead.

Log in to add feedback

category_exists( int|string $cat_name, int $category_parent = null ): string|null

In this article

Description

See also

Parameters

Return

Source

Changelog

User Contributed Notes