Pagination

A pagination row: circle, rounded, pill, 3D, transparent or button styling, in three sizes and any alignment. It is shown in the block inserter as Canvas Pagination and registered as canvas-core/pagination.

Select the block on a page and its own settings open in the sidebar, in the panels below:

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Items

• ItemsDefaultEmpty

  The controls in the row, in the order listed here: page numbers, previous and next arrows, and any gap markers between them. Nothing is shown until you add at least one.

  Each row of Items takes:

  • LabelDefaultEmpty

    Inline markup is allowed, so a glyph, a « chevron or a "1 OF 3" status line all work.

  • URLDefault#

    Page this control opens.

  • StateDefaultEmpty

    Marks this control as the page a reader is on, or greys it out where there is nowhere further to go.

    ChoicesNormal (empty)Current pageDisabled

  • Accessible NameDefaultEmpty

    Needed when the label is only a glyph: e.g. "Previous".

  • Extra Link ClassesDefaultEmpty

    Classes on this one control, for a colour or spacing the rest of the row does not carry.

  • Not FocusableDefaultOff

    Takes this control out of keyboard order and tells assistive technology it cannot be used, for one that is shown but not yet available.

Style

• ShapeDefaultEmpty

  How the corners of each control are cut.

  ChoicesSquare (Default) (empty)CircleRoundedPill

• 3DDefaultOff

  Thickens the bottom edge of each control so the row reads as slightly raised off the page.

• TransparencyDefaultEmpty

  Transparent removes the item backgrounds; Transparent Inside keeps the outer frame and clears only the items within it.

  ChoicesFilled (Default) (empty)TransparentTransparent Inside

• Button TreatmentDefaultOff

  Renders each item as a standalone button rather than a joined row.

• ColourDefaultEmpty

  Which colour from the theme palette the controls take.

  ChoicesDefault (empty)PrimarySecondarySuccessDangerInfoLightDark

• SizeDefaultEmpty

  How large the controls are drawn. Large gives an easier target on a touch screen.

  ChoicesDefault (empty)LargeSmall

• AlignmentDefaultEmpty

  Where the row of controls sits across the width available to it.

  ChoicesStart (empty)CenterEnd

Related

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Interactive: Accordions, AJAX Buttons, Carousels, Cookie Consent, Countdowns, Flip Cards.