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

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


Parameters

$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 ↑

Source

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 ↑

Changelog

Changelog
Version Description
0.71 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 2 content
    Contributed by oliverdrummond

    $parents
     ▪ ‘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.