Categories List WordPress Block

Display a list of all categories.

This block is available in the latest version of WordPress and does not require the Gutenberg plugin.

Last updated

January 21, 2023

For developers

Block Grammar & Markup

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

Block Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

displayAsDropdown, showEmpty, showHierarchy, showOnlyTopLevel, showPostCounts

{
  "displayAsDropdown": {
    "type": "boolean",
    "default": false
  },
  "showHierarchy": {
    "type": "boolean",
    "default": false
  },
  "showPostCounts": {
    "type": "boolean",
    "default": false
  },
  "showOnlyTopLevel": {
    "type": "boolean",
    "default": false
  },
  "showEmpty": {
    "type": "boolean",
    "default": false
  }
}

Block Supports

Optional. Type: Object.

A set of options that enables or disables block controls in the editor, for example gradient colors or padding.

Documentation

Align, color: background, color: text, spacing: margin, spacing: padding, typography: __experimentalFontFamily, typography: __experimentalFontStyle, typography: __experimentalFontWeight, typography: __experimentalLetterSpacing, typography: __experimentalTextDecoration, typography: __experimentalTextTransform, typography: fontSize, typography: lineHeight

{
  "align": true,
  "html": false,
  "spacing": {
    "margin": true,
    "padding": true
  },
  "typography": {
    "fontSize": true,
    "lineHeight": true,
    "__experimentalFontFamily": true,
    "__experimentalFontWeight": true,
    "__experimentalFontStyle": true,
    "__experimentalTextTransform": true,
    "__experimentalTextDecoration": true,
    "__experimentalLetterSpacing": true,
    "__experimentalDefaultControls": {
      "fontSize": true
    }
  }
}