Codex

Attention Help us to improve the Codex by filling out our documentation survey!

Function Reference/the category

Languages: English • Русский • 日本語 • (Add your language)

Contents

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

$separator
(string) (optional) Text or character to display between each category link. By default, the links are placed in an HTML unordered list. An empty string will result in the default behavior.
Default: empty string
$parents
(string) (optional) 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.
Default: empty string
Note: Default is a link to the child category, with no relationship exhibited.
$post_id
(int) (optional) Post ID to retrieve categories. The default value false results in the category list of the current post.
Default: false

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(' &bull; '); ?></p>

Post Categories: WordPress • Computers • Blogging

Source Code

Changelog

  • Since 0.71
  • 2.5 : Added the post_id parameter.

Related

Categories: the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category(), the_taxonomies

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/the_category"

Codex Resources