Taxonomies Edit

Schema Schema

The schema defines all the fields that exist within a taxonomy record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.

capabilities

object
All capabilities used by the taxonomy.

Read only

Context: edit

description

string
A human-readable description of the taxonomy.

Read only

Context: view, edit

hierarchical

boolean
Whether or not the taxonomy should have children.

Read only

Context: view, edit

labels

object
Human-readable labels for the taxonomy for various contexts.

Read only

Context: edit

name

string
The title for the taxonomy.

Read only

Context: view, edit, embed

slug

string
An alphanumeric identifier for the taxonomy.

Read only

Context: view, edit, embed

show_cloud

boolean
Whether or not the term cloud should be displayed.

Read only

Context: edit

types

array
Types associated with the taxonomy.

Read only

Context: view, edit

rest_base

string
REST base route for the taxonomy.

Read only

Context: view, edit, embed

visibility

object
The visibility settings for the taxonomy.

Read only

Context: edit

Top ↑

Retrieve a Taxonomy Retrieve a Taxonomy

Top ↑

Definition & Example Request Definition & Example Request

GET /wp/v2/taxonomies

Query this endpoint to retrieve a specific taxonomy record.

$ curl https://example.com/wp-json/wp/v2/taxonomies

Top ↑

Arguments Arguments

context Scope under which the request is made; determines fields present in response.

Default: view

One of: view, embed, edit

type Limit results to taxonomies associated with a specific post type.

Top ↑

Retrieve a Taxonomy Retrieve a Taxonomy

Top ↑

Definition & Example Request Definition & Example Request

GET /wp/v2/taxonomies/<taxonomy>

Query this endpoint to retrieve a specific taxonomy record.

$ curl https://example.com/wp-json/wp/v2/taxonomies/<taxonomy>

Top ↑

Arguments Arguments

taxonomy An alphanumeric identifier for the taxonomy.
context Scope under which the request is made; determines fields present in response.

Default: view

One of: view, embed, edit