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

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

Description Description

Parameters Parameters


(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 value: ''


(string) (Optional) How to display the parents.

Default value: ''


(int) (Optional) Post ID to retrieve categories.

Default value: false

Top ↑

Source Source

File: wp-includes/category-template.php

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

Top ↑

Changelog Changelog

Version Description
0.71 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 5 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.