wp_delete_category() – Function | Developer.WordPress.org

wp_delete_category( int $cat_id ): bool|int|WP_Error

Deletes one existing category.

Parameters

$cat_idintrequired: Category term ID.

Return

bool|int|WP_Error Returns true if completes delete action; false if term doesn’t exist; Zero on attempted deletion of default Category; WP_Error object is also a possibility.

Source

function wp_delete_category( $cat_id ) {
	return wp_delete_term( $cat_id, 'category' );
}

View all references View on Trac View on GitHub

Uses	Description
wp_delete_term()`wp-includes/taxonomy.php`	Removes a term from the database.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Codex 10 years ago

Example

<?php
$categ_ID = 3;
if ( wp_delete_category( $categ_ID ) ) {
  echo "Category #$categ_ID was successfully deleted";
} else {
  echo "Impossible to delete category #$categ_ID! Make sure it exists and that it's not the default category";
}
?>

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