Query Title

This document is part of the WordPress block reference and is intended for developers.

Display the query title.

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

Last updated

March 13, 2025

Category: Theme

Block variations: Archive title, Search title

For developers

View source on GitHub

Block Grammar & Markup

<!-- wp:query-title /-->

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

{
  "type": {
    "type": "string"
  },
  "textAlign": {
    "type": "string"
  },
  "level": {
    "type": "number",
    "default": 1
  },
  "levelOptions": {
    "type": "array"
  },
  "showPrefix": {
    "type": "boolean",
    "default": true
  },
  "showSearchTerm": {
    "type": "boolean",
    "default": true
  }
}

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": [
    "wide",
    "full"
  ],
  "html": false,
  "color": {
    "gradients": true,
    "__experimentalDefaultControls": {
      "background": true,
      "text": true
    }
  },
  "spacing": {
    "margin": true,
    "padding": true
  },
  "typography": {
    "fontSize": true,
    "lineHeight": true,
    "__experimentalFontFamily": true,
    "__experimentalFontStyle": true,
    "__experimentalFontWeight": true,
    "__experimentalLetterSpacing": true,
    "__experimentalTextTransform": true,
    "__experimentalTextDecoration": true,
    "__experimentalDefaultControls": {
      "fontSize": true
    }
  },
  "interactivity": {
    "clientNavigation": true
  },
  "__experimentalBorder": {
    "radius": true,
    "color": true,
    "width": true,
    "style": true,
    "__experimentalDefaultControls": {
      "radius": true,
      "color": true,
      "width": true,
      "style": true
    }
  }
}

View blocks per attribute or block support:

Block Attributes