get_term_meta( int $term_id, string $key = '', bool $single = false )

Retrieves metadata for a term.



(int) (Required) Term ID.


(string) (Optional) The meta key to retrieve. By default, returns data for all keys.

Default value: ''


(bool) (Optional) Whether to return a single value. This parameter has no effect if $key is not specified.

Default value: false

Top ↑


(mixed) An array of values if $single is false. The value of the meta field if $single is true. False for an invalid $term_id (non-numeric, zero, or negative value). An empty string if a valid but non-existing term ID is passed.

Top ↑


File: wp-includes/taxonomy.php

function get_term_meta( $term_id, $key = '', $single = false ) {
	return get_metadata( 'term', $term_id, $key, $single );

Top ↑


Version Description
4.4.0 Introduced.

Top ↑

User Contributed Notes

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