Retrieves information about registered taxonomies.

See references for built-in taxonomies and custom taxonomies.

Subcommands

wp taxonomy get

Gets details about a registered taxonomy.

Synopsis

wp taxonomy get <taxonomy> [--field=<field>] [--fields=<fields>] [--format=<format>]

Options

<taxonomy>
: Taxonomy slug.

[--field=<field>]
: Instead of returning the whole taxonomy, returns the value of a single field.

[--fields=<fields>]
: Limit the output to specific fields. Defaults to all fields.

[--format=<format>]
: Render output in a particular format. Default: table. Options: table, csv, json, yaml.

Available Fields

Default fields: name, label, description, object_type, show_tagcloud, hierarchical, public, labels, cap.

Optional fields: count.

Examples

# Get details of `category` taxonomy.
$ wp taxonomy get category --fields=name,label,object_type
+-------------+------------+
| Field       | Value      |
+-------------+------------+
| name        | category   |
| label       | Categories |
| object_type | ["post"]   |
+-------------+------------+

# Get capabilities of 'post_tag' taxonomy.
$ wp taxonomy get post_tag --field=cap
{"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"}

wp taxonomy list

Lists registered taxonomies.

Synopsis

wp taxonomy list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>]

Options

[--<field>=<value>]
: Filter by one or more fields (see get_taxonomies() first parameter for a list of available fields).

[--field=<field>]
: Prints the value of a single field for each taxonomy.

[--fields=<fields>]
: Limit the output to specific taxonomy fields.

[--format=<format>]
: Render output in a particular format. Default: table. Options: table, csv, json, count, yaml.

Available Fields

Default fields: name, label, description, object_type, show_tagcloud, hierarchical, public.

Optional fields: count.

Examples

# List all taxonomies.
$ wp taxonomy list --format=csv
name,label,description,object_type,show_tagcloud,hierarchical,public
category,Categories,,post,1,1,1
post_tag,Tags,,post,1,,1
nav_menu,"Navigation Menus",,nav_menu_item,,,
link_category,"Link Categories",,link,1,,
post_format,Format,,post,,,1

# List all taxonomies with 'post' object type.
$ wp taxonomy list --object_type=post --fields=name,public
+-------------+--------+
| name        | public |
+-------------+--------+
| category    | 1      |
| post_tag    | 1      |
| post_format | 1      |
+-------------+--------+

Examples

# List all taxonomies with 'post' object type.
$ wp taxonomy list --object_type=post --fields=name,public
+-------------+--------+
| name        | public |
+-------------+--------+
| category    | 1      |
| post_tag    | 1      |
| post_format | 1      |
+-------------+--------+

# Get capabilities of 'post_tag' taxonomy.
$ wp taxonomy get post_tag --field=cap
{"manage_terms":"manage_categories","edit_terms":"manage_categories","delete_terms":"manage_categories","assign_terms":"edit_posts"}