WordPress at Your Fingertips

wp_delete_object_term_relationships() WP 1.0

Will unlink the object from the taxonomy or taxonomies.

Will remove all relationships between the object and any terms in a particular taxonomy or taxonomies. Does not remove the term or taxonomy itself.

No Hooks.


null. Nothing.


wp_delete_object_term_relationships( $object_id, $taxonomies );
$object_id(int) (required)
The term Object Id that refers to the term.
$taxonomies(string|array) (required)
List of Taxonomy Names or single Taxonomy name.


Since 2.3.0 Introduced.

Code of wp_delete_object_term_relationships() WP 5.8.1

function wp_delete_object_term_relationships( $object_id, $taxonomies ) {
	$object_id = (int) $object_id;

	if ( ! is_array( $taxonomies ) ) {
		$taxonomies = array( $taxonomies );

	foreach ( (array) $taxonomies as $taxonomy ) {
		$term_ids = wp_get_object_terms( $object_id, $taxonomy, array( 'fields' => 'ids' ) );
		$term_ids = array_map( 'intval', $term_ids );
		wp_remove_object_terms( $object_id, $term_ids, $taxonomy );

Term (taxonomies terms)

For posts

No comments
    Log In