Title: get_term_field
Published: April 25, 2014
Last modified: February 24, 2026

---

# get_term_field( string $field, int|WP_Term $term, string $taxonomy, string $context ): string|int|null|󠀁[WP_Error](https://developer.wordpress.org/reference/classes/wp_error/)󠁿

## In this article

 * [Description](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#see-also)
 * [Parameters](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#wp--skip-link--target)

Gets sanitized term field.

## 󠀁[Description](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#description)󠁿

The function is for contextual reasons and for simplicity of usage.

### 󠀁[See also](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#see-also)󠁿

 * [sanitize_term_field()](https://developer.wordpress.org/reference/functions/sanitize_term_field/)

## 󠀁[Parameters](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#parameters)󠁿

 `$field`stringrequired

Term field to fetch.

`$term`int|[WP_Term](https://developer.wordpress.org/reference/classes/wp_term/)
required

Term ID or object.

`$taxonomy`stringoptional

Taxonomy name. Default empty.

`$context`stringoptional

How to sanitize term fields. Look at [sanitize_term_field()](https://developer.wordpress.org/reference/functions/sanitize_term_field/)
for available options.
 Default `'display'`.

More Arguments from sanitize_term_field( … $context )

Context in which to sanitize the term field.
 Accepts `'raw'`, `'edit'`, `'db'`,`'
display'`, `'rss'`, `'attribute'`, or `'js'`. Default `'display'`.

## 󠀁[Return](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#return)󠁿

 string|int|null|[WP_Error](https://developer.wordpress.org/reference/classes/wp_error/)
Will return an empty string if $term is not an object or if $field is not set in
$term.

## 󠀁[Source](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#source)󠁿

    ```php
    function get_term_field( $field, $term, $taxonomy = '', $context = 'display' ) {
    	$term = get_term( $term, $taxonomy );
    	if ( is_wp_error( $term ) ) {
    		return $term;
    	}

    	if ( ! is_object( $term ) ) {
    		return '';
    	}

    	if ( ! isset( $term->$field ) ) {
    		return '';
    	}

    	return sanitize_term_field( $field, $term->$field, $term->term_id, $term->taxonomy, $context );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/taxonomy.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/taxonomy.php#L1221)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/taxonomy.php#L1221-L1236)

## 󠀁[Related](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#related)󠁿

| Uses | Description | 
| [sanitize_term_field()](https://developer.wordpress.org/reference/functions/sanitize_term_field/)`wp-includes/taxonomy.php` |

Sanitizes the field value in the term based on the context.

  | 
| [get_term()](https://developer.wordpress.org/reference/functions/get_term/)`wp-includes/taxonomy.php` |

Gets all term data from database by term ID.

  | 
| [is_wp_error()](https://developer.wordpress.org/reference/functions/is_wp_error/)`wp-includes/load.php` |

Checks whether the given variable is a WordPress Error.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#)

| Used by | Description | 
| [WP_REST_Menu_Items_Controller::prepare_links()](https://developer.wordpress.org/reference/classes/wp_rest_menu_items_controller/prepare_links/)`wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php` |

Prepares links for the request.

  | 
| [WP_REST_Menu_Items_Controller::prepare_item_for_database()](https://developer.wordpress.org/reference/classes/wp_rest_menu_items_controller/prepare_item_for_database/)`wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php` |

Prepares a single nav menu item for create or update.

  | 
| [WP_Customize_Nav_Menu_Item_Setting::get_original_title()](https://developer.wordpress.org/reference/classes/wp_customize_nav_menu_item_setting/get_original_title/)`wp-includes/customize/class-wp-customize-nav-menu-item-setting.php` |

Get original title.

  | 
| [term_description()](https://developer.wordpress.org/reference/functions/term_description/)`wp-includes/category-template.php` |

Retrieves term description.

  | 
| [wp_setup_nav_menu_item()](https://developer.wordpress.org/reference/functions/wp_setup_nav_menu_item/)`wp-includes/nav-menu.php` |

Decorates a menu item object with the shared navigation menu item properties.

  | 
| [wp_update_nav_menu_item()](https://developer.wordpress.org/reference/functions/wp_update_nav_menu_item/)`wp-includes/nav-menu.php` |

Saves the properties of a menu item or create a new one.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/get_term_field/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.4.0](https://developer.wordpress.org/reference/since/4.4.0/) | The `$taxonomy` parameter was made optional. `$term` can also now accept a [WP_Term](https://developer.wordpress.org/reference/classes/wp_term/) object. | 
| [2.3.0](https://developer.wordpress.org/reference/since/2.3.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fget_term_field%2F)
before being able to contribute a note or feedback.