clean_object_term_cache( int|array $object_ids, array|string $object_type )

Removes the taxonomy relationship to terms from the cache.

Description Description

Will remove the entire taxonomy relationship containing term $object_id. The term IDs have to exist within the taxonomy $object_type for the deletion to take place.

See also See also

Top ↑

Parameters Parameters


(int|array) (Required) Single or list of term object ID(s).


(array|string) (Required) The taxonomy object type.

Top ↑

Source Source

File: wp-includes/taxonomy.php

function clean_object_term_cache($object_ids, $object_type) {
	global $_wp_suspend_cache_invalidation;

	if ( ! empty( $_wp_suspend_cache_invalidation ) ) {

	if ( !is_array($object_ids) )
		$object_ids = array($object_ids);

	$taxonomies = get_object_taxonomies( $object_type );

	foreach ( $object_ids as $id ) {
		foreach ( $taxonomies as $taxonomy ) {
			wp_cache_delete($id, "{$taxonomy}_relationships");

	 * Fires after the object term cache has been cleaned.
	 * @since 2.5.0
	 * @param array  $object_ids An array of object IDs.
	 * @param string $object_type Object type.
	do_action( 'clean_object_term_cache', $object_ids, $object_type );

Top ↑

Changelog Changelog

Version Description
2.3.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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