Delete Custom Taxonomy Term is a WordPress ability from Advanced Custom Fields — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Delete Custom Taxonomy Term

Destructive

Delete a term from a specific AI-accessible ACF custom taxonomy by ID.

Requires Advanced Custom Fields (ACF) 6.8.0+ on a WordPress install where the Abilities API is available (native from WordPress 6.9, or via a compatible Abilities/Feature API polyfill). ACF's global 'Allow AI Access' setting (enable_acf_ai) must be turned on, and each individual field group, custom post type, or custom taxonomy must also have its own 'Allow AI Access' toggle enabled and be exposed in the REST API (show_in_rest) before its abilities are registered. Most abilities additionally require the current user to hold ACF's configured management capability (acf_get_setting('capability'), default manage_options) or the matching WordPress post-type/taxonomy capability (create_posts, edit_posts, delete_posts, manage_terms, edit_terms, delete_terms).

What it does

ACF dynamically registers one of these delete abilities for every eligible custom taxonomy — the ability ID follows the pattern acf/delete-{taxonomy-slug} (e.g. acf/delete-genre). It proxies a DELETE request to that term's WordPress REST API endpoint. Terms cannot be trashed like posts, so the request defaults to a permanent, forced deletion. Because it permanently removes content, this ability is flagged destructive.

See it in action

You ask your AI assistant

"Delete the Genre term with ID 7."

Inputs

Name Type Required Description
id integer Yes The ID of the term to delete.
force boolean No Whether to permanently delete the term. Defaults to true, since terms cannot be trashed.

Returns

The deleted term, as returned by the taxonomy's WordPress REST API endpoint.

Permission

The current user must have the taxonomy's 'delete_terms' capability.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.