Function: in_category

in_category( integer | string | array $category, integer | object $post )

Checks if the current post is within any of the given categories.

Shortcut: ic

You can use above key combination to trigger the associated snippet for this function in the WordPress Snippets for Visual Studio Code extension. You can also use this shortcut to search for this function on this website.

The given categories are checked against the post's categories' term_ids, names and slugs. Categories given as integers will only be checked against the post's categories' term_ids.

Prior to v2.5 of WordPress, category names were not supported. Prior to v2.7, category slugs were not supported. Prior to v2.7, only one category could be compared: in_category( $single_category ). Prior to v2.7, this function could only be used in the WordPress Loop. As of 2.7, the function can be used anywhere if it is provided a post ID or post object.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters

Name Type(s) Default Value Description
$category integer | string | array

Category ID, name or slug, or array of said.

$post integer | object null

Optional. Post to check instead of the current post. (since 2.7.0)

Returns

boolean

True if the current post is in any of the given categories.

WordPress Developer Newsletter

Stay informed of new chapter releases, important WordPress API updates and more.