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 ); ?>

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.

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

WordPress.org

Codex

Template Tags/the category

Contents