the_category( string $separator = '', string $parents = '', int $post_id = false )

Displays category list for a post in either HTML list or custom format.


$separator string Optional
Separator between the categories. By default, the links are placed in an unordered list. An empty string will result in the default behavior.

Default: ''

$parents string Optional
How to display the parents. Accepts 'multiple', 'single', or empty.

Default: ''

$post_id int Optional
ID of the post to retrieve categories for. Defaults to the current post.

Default: false

Top ↑


File: wp-includes/category-template.php. View all references

function the_category( $separator = '', $parents = '', $post_id = false ) {
	echo get_the_category_list( $separator, $parents, $post_id );

Top ↑


Version Description
0.71 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 2 content
    Contributed by oliverdrummond

     ▪ ‘multiple’ – Display separate links to parent and child categories, exhibiting “parent/child” relationship. (Exhibiting the parents and child with links pointing for both)
     ▪ ‘single’ – Display link to child category only, with link text exhibiting “parent/child” relationship. (Exhibiting the parents and child but the link points only to the child category)

You must log in before being able to contribute a note or feedback.