get_cat_ID() – Function | Developer.WordPress.org

Retrieves the ID of a category from its name.

Parameters

$cat_namestringrequired: Category name.

Return

int Category ID on success, 0 if the category doesn’t exist.

Source

function get_cat_ID( $cat_name ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid
	$cat = get_term_by( 'name', $cat_name, 'category' );

	if ( $cat ) {
		return $cat->term_id;
	}

	return 0;
}

View all references View on Trac View on GitHub

Uses	Description
get_term_by()`wp-includes/taxonomy.php`	Gets all term data from database by term field and data.

Used by	Description
wp_xmlrpc_server::mw_editPost()`wp-includes/class-wp-xmlrpc-server.php`	Edits a post.
wp_xmlrpc_server::mw_newPost()`wp-includes/class-wp-xmlrpc-server.php`	Creates a new post.

Changelog

Version	Description
1.0.0	Introduced.

User Contributed Notes

Skip to note 3 content

hearvox 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Example:
```
<?php $cat_id = get_cat_ID ( 'Category Name' ); ?>
```
Log in to add feedback
Skip to note 4 content

hearvox 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Useful for a function such as category_description() that requires a category’s ID:
```
<?php $cat_id = get_cat_ID ( 'Category Name', 'textdomain' ); ?>
<p>The 'Category Name' description is: <?php echo category_description( $cat_id ) ?></p>
```
Log in to add feedback

get_cat_ID( string $cat_name ): int

In this article

Parameters

Return

Source

Changelog

User Contributed Notes

get_cat_ID( string $cat_name ): int

In this article

Parameters

Return

Source

Related

Changelog

User Contributed Notes