Function Reference/wp delete term

Description

Removes a term from the database.

<?php wp_delete_term( $term_id, $taxonomy, $args ) ?>

$term_id

(int) (required) The ID of the term.

Default: None

$taxonomy

(string) (required) The context in which to relate the term to the object.

Default: None

$args

(array) (optional) Overwrite term field values.

Default: None

bool | WP_Error: Returns false if not term; true if completes delete action.

<?php wp_delete_term( 25, 'category' ) ?> Deletes the term with the ID 25 from the taxonomy "category" using the default function arguments

If the term is a parent of other terms, then the children will be updated to that term's parent.

The $args 'default' will only override the terms found, if there is only one term found. Any other and the found terms are used.

The $args 'force_default' will force the term supplied as default to be assigned even if the object was not going to be termless.

Since: 2.3.0

wp_delete_term() is located in wp-includes/taxonomy.php.

See also index of Function Reference and index of Template Tags.