delete_term_meta( int $term_id, string $meta_key, mixed $meta_value = '' )

Removes metadata matching criteria from a term.

Description Description

Parameters Parameters


(int) (Required) Term ID.


(string) (Required) Metadata name.


(mixed) (Optional) Metadata value. If provided, rows will only be removed that match the value.

Default value: ''

Top ↑

Return Return

(bool) True on success, false on failure.

Top ↑

Source Source

File: wp-includes/taxonomy.php

function delete_term_meta( $term_id, $meta_key, $meta_value = '' ) {
	// Bail if term meta table is not installed.
	if ( get_option( 'db_version' ) < 34370 ) {
		return false;

	$deleted = delete_metadata( 'term', $term_id, $meta_key, $meta_value );

	// Bust term query cache.
	if ( $deleted ) {
		wp_cache_set( 'last_changed', microtime(), 'terms' );

	return $deleted;

Top ↑

Changelog Changelog

Version Description
4.4.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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