get_category_parents( int $id, bool $link = false, string $separator = '/', bool $nicename = false, array $deprecated = array() )

Retrieve category parents with separator.

Description Description

Parameters Parameters


(int) (Required) Category ID.


(bool) (Optional) Whether to format with link.

Default value: false


(string) (Optional) How to separate categories.

Default value: '/'


(bool) (Optional) Whether to use nice name for display.

Default value: false


(array) (Optional) Not used.

Default value: array()

Top ↑

Return Return

(string|WP_Error) A list of category parents on success, WP_Error on failure.

Top ↑

Source Source

File: wp-includes/category-template.php

function get_category_parents( $id, $link = false, $separator = '/', $nicename = false, $deprecated = array() ) {

	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '4.8.0' );

	$format = $nicename ? 'slug' : 'name';

	$args = array(
		'separator' => $separator,
		'link'      => $link,
		'format'    => $format,

	return get_term_parents_list( $id, 'category', $args );

Top ↑

Changelog Changelog

Version Description
4.8.0 The $visited parameter was deprecated and renamed to $deprecated.
1.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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