handbook/commands/term.md
github-actions[bot] ff2a543077 Regenerate handbook
2026-07-21 08:35:57 +00:00

39 lines
1.1 KiB
Markdown

# wp term
Manages taxonomy terms and term meta, with create, delete, and list commands.
See reference for [taxonomies and their terms](https://wordpress.org/documentation/article/taxonomies).
### 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.