Function Reference/the category ID

This page redirects to an external site: https://developer.wordpress.org/reference/functions/the_category_ID/

Languages: English • 日本語 (Add your language)

This function has been deprecated since Version 0.71. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists. See also wp-includes/deprecated.php. Use get_the_category instead.

1 Description
2 Replace With
3 Usage
4 Parameters
5 Example
6 Change Log
7 Related

Description

Displays or returns the numeric ID of the category a post belongs to. This tag must be used within The Loop.

Replace With

This tag was deprecated when multiple categories were added to WordPress, and there is no one-to-one correspondence with another tag. This PHP code block provides an example for how you can replace it:

<?php 
foreach((get_the_category()) as $category) { 
    echo $category->cat_ID . ' '; 
} ?>

Usage

<?php the_category_ID( $echo ); ?>

Parameters

echo: (boolean) Display the category ID (TRUE) or return it for use in PHP (FALSE). Defaults to TRUE.

Example

Displays a corresponding image for each category.

<img src="<?php the_category_ID(); ?>.gif" />

Change Log

Since: 0.71
Deprecated: ?
Replace By: none

See also index of Function Reference and index of Template Tags.

Codex