Terms List

In this article


Display a list of all terms of a given taxonomy.

  • Name: core/categories
  • Category: widgets
  • API Version: 3
  • Block Type: Dynamic (server-rendered)
  • Keywords: categories

Attributes

Defined via the attributes property in block.json.

Attribute Type Default Description
taxonomy string "category"
displayAsDropdown boolean false
showHierarchy boolean false
showPostCounts boolean false
showOnlyTopLevel boolean false
showEmpty boolean false
label string Role: content
showLabel boolean true

Supports

Defined via the supports property in block.json.

Context

Defined via the usesContext and providesContext properties in block.json.

Uses context:

  • enhancedPagination

Block Markup

This is a dynamic block. It is rendered on the server and does not save HTML in post content.

In post content, it is stored as a block comment:

<!-- wp:core/categories {"showPostCounts":false,"displayAsDropdown":false,"showHierarchy":false} /-->

Source