handbook/commands/term.md

wp term

Manages taxonomy terms and term meta, with create, delete, and list commands.

See reference for taxonomies and their terms.

EXAMPLES

# Create a new term.
$ wp term create category Apple --description="A type of fruit"
Success: Created category 199.

# Get details about a term.
$ wp term get category 199 --format=json --fields=term_id,name,slug,count
{"term_id":199,"name":"Apple","slug":"apple","count":1}

# Update an existing term.
$ wp term update category 15 --name=Apple
Success: Term updated.

# Get the term's URL.
$ wp term list post_tag --include=123 --field=url
http://example.com/tag/tips-and-tricks

# Delete post category
$ wp term delete category 15
Success: Deleted category 15.

# Recount posts assigned to each categories and tags
$ wp term recount category post_tag
Success: Updated category term count
Success: Updated post_tag term count

# Prune terms with 0 or 1 published posts
$ wp term prune post_tag
Deleted post_tag 15.
Success: Pruned 1 of 5 terms.