term_description( int $term, null $deprecated = null ): string

Retrieves term description.


$term int Optional
Term ID. Defaults to the current term ID.
$deprecated null Optional
Deprecated. Not used.

Default: null

Top ↑


string Term description, if available.

Top ↑

More Information

First available with WordPress Version 2.8, this template tag returns the description of a given term. A term ID and taxonomy are as parameters. If no term ID is passed, the description of current queried term (e.g. post category or tag) will be returned.

Output is wrapped in <p> tags.

Top ↑


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

function term_description( $term = 0, $deprecated = null ) {
	if ( ! $term && ( is_tax() || is_tag() || is_category() ) ) {
		$term = get_queried_object();
		if ( $term ) {
			$term = $term->term_id;

	$description = get_term_field( 'description', $term );

	return is_wp_error( $description ) ? '' : $description;

Top ↑


Version Description
4.9.2 The $taxonomy parameter was deprecated.
2.8.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 2 content
    Contributed by Elías

    If you want to filter the description, don’t use this function, use get_the_archive_description() instead. This one does apply_filters before returning the description, and uses term_description() internally to retrieve the description when is for a term.

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