Pagination

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

• Name: core/query-pagination
• Category: theme
• API Version: 3
• Block Type: Hybrid (static save + server enhancements)

Block Relationships

Ancestor blocks:
– core/query

Allowed inner blocks:
– core/query-pagination-previous
– core/query-pagination-numbers
– core/query-pagination-next

Attributes

Defined via the attributes property in block.json.

Attribute	Type	Default	Description
paginationArrow	string	"none"	—
showLabel	boolean	true	—

Supports

Defined via the supports property in block.json.

• anchor: true
• align: true
• reusable: false
• html: false
• color:
  • gradients: true
  • link: true
• layout:
  • allowSwitching: false
  • allowInheriting: false
  • default: {"type":"flex"}
• typography:
  • fontSize: true
  • lineHeight: true
• interactivity:
  • clientNavigation: true

Context

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

Uses context:

• queryId
• query

Provides context:

• paginationArrow → attribute paginationArrow
• showLabel → attribute showLabel

Block Markup

This is a hybrid block. It saves static markup that the server may enhance during rendering.

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

Source

• block.json (reference)
• Source directory — browse edit.js, save.js, index.php, and more.