No results

Contains the block elements used to render content when no query results are found.

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

Last updated

March 13, 2025

Category: Theme

For developers

View source on GitHub

Block Grammar & Markup

<!-- wp:query-no-results -->
<!-- wp:paragraph {"placeholder":"Add a text or blocks that will display when the query returns no results."} -->
<p></p>
<!-- /wp:paragraph -->
<!-- /wp:query-no-results -->

Ancestor

Optional. Type: Array.

A block with an ancestor can be placed as an inner block of the ancestor. Either as a direct child block of the ancestor, or nested.

That allows, for example, to place a ‘Comment Content’ block inside a ‘Column’ block, as long as ‘Column’ is somewhere within a ‘Comment Template’ block.

In comparison to the parent property blocks that specify their ancestor can be placed anywhere in the subtree whilst blocks with a specified parent need to be direct children.

Documentation

[
  "core/query"
]

Context

Context is used to pass values from a block to a descendant block; for example, a query and post template passing the query ID to the inner blocks.

Documentation

Uses context. Optional. Type: Object.

[
  "queryId",
  "query"
]

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": true,
  "reusable": false,
  "html": false,
  "color": {
    "gradients": true,
    "link": true
  },
  "typography": {
    "fontSize": true,
    "lineHeight": true,
    "__experimentalFontFamily": true,
    "__experimentalFontWeight": true,
    "__experimentalFontStyle": true,
    "__experimentalTextTransform": true,
    "__experimentalTextDecoration": true,
    "__experimentalLetterSpacing": true,
    "__experimentalDefaultControls": {
      "fontSize": true
    }
  },
  "interactivity": {
    "clientNavigation": true
  }
}

View blocks per attribute or block support:

Block Attributes