WordPress.org

Template Tags/the category

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

Description

Displays a link to the category or categories a post belongs to. This tag must be used within The Loop.

Usage

<?php the_category( $separator, $parents, $post_id ); ?>

Parameters

How to Pass Tag Parameters: Tags with PHP function-style parameters

separator

(string) Text or character to display between each category link. The default is to place the links in an unordered list.

parents

(string) How to display links that reside in child (sub) categories. Options are:

'multiple' - Display separate links to parent and child categories, exhibiting "parent/child" relationship.
'single' - Display link to child category only, with link text exhibiting "parent/child" relationship.

Note: Default is a link to the child category, with no relationship exhibited.

post_id

(Integer) Post ID to retrieve categories. The default value is false (the current post).

Examples

Separated by Space

This usage lists categories with a space as the separator.

<p>Categories: <?php the_category(' '); ?></p>

Categories: WordPress Computers Blogging

Separated by Comma

Displays links to categories, each category separated by a comma (if more than one).

<p>This post is in: <?php the_category(', '); ?></p>

This post is in: WordPress, Computers, Blogging

Separated by Arrow

Displays links to categories with an arrow (>) separating the categories. (Note: Take care when using this, since some viewers may interpret a category following a > as a subcategory of the one preceding it.)

<p>Categories: <?php the_category(' &gt; '); ?></p>

Categories: WordPress > Computers > Blogging

Separated by a Bullet

Displays links to categories with a bullet (•) separating the categories.

<p>Post Categories: <?php the_category(' • '); ?></p>

Post Categories: WordPress • Computers • Blogging

Source Code

the_category() is located in wp-includes/category-template.php

Changelog

2.5 : Added the post_id parameter.