Pagination

Displays a paginated navigation to next/previous set of posts, when applicable.

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

Last updated

Category:

For developers

Block Grammar & Markup

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

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

Provides context. Optional. Type: Object.

{
  "paginationArrow": "paginationArrow",
  "showLabel": "showLabel"
}

Uses context. Optional. Type: Object.

[
  "queryId",
  "query"
]

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

{
  "paginationArrow": {
    "type": "string",
    "default": "none"
  },
  "showLabel": {
    "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": true,
  "reusable": false,
  "html": false,
  "color": {
    "gradients": true,
    "link": true,
    "__experimentalDefaultControls": {
      "background": true,
      "text": true,
      "link": true
    }
  },
  "layout": {
    "allowSwitching": false,
    "allowInheriting": false,
    "default": {
      "type": "flex"
    }
  },
  "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: