When to use
- Long card lists — articles, resources or results that would otherwise push everything below them off the page.
- Any set of siblings — the block pages the direct children of whatever component it targets.
Key decisions
- Target: give the component to paginate an ID, and enter the same value in Paginated Component ID. Its direct children become the items; a group of cards is unwrapped so each card counts as one.
- Items Per Page: a multiple of the cards per row, so no page ends on a half-empty row.
- Max Pages in Navigation: how many page numbers show at once. Three suits most lists.
- Summary: the template takes {{currentFirstItem}}, {{currentLastItem}} and {{totalResults}}. Hide it when the count adds nothing.
Example
Nine cards, three per page. The section holding them has the ID pagination-demo, and the Pagination block beneath the cards points at it.
Migration
Architecture
Governance
All authoring options
General
id: optional id for the pagination element itself
paginatedCompId: ID of the component to paginate. Must match exactly
maxPageCount: page numbers shown at once. Default 3, range 1–20
itemsPerPage: items on each page. Default 10, range 1–100
hideResultsSummary: boolean — hide the summary line
resultsSummaryTemplate: rich text with {{currentFirstItem}}, {{currentLastItem}}, {{totalResults}}
First and last buttons
firstLastMode: boolean — show First and Last buttons
firstPageNavLabel / lastPageNavLabel: visible text. Default "First" / "Last"
firstPageNavAriaLabel / lastPageNavAriaLabel: screen reader labels. Default "First page" / "Last page"
Previous and next buttons
prevNextMode: boolean — text labels instead of arrow icons
prevPageNavLabel / nextPageNavLabel: visible text when prevNextMode is on
prevPageNavAriaLabel / nextPageNavAriaLabel: screen reader labels. Default "Previous page" / "Next page"
Analytics
classes_track-inview: emit an event when the block scrolls into view
classes_track-change: emit an event on every page change
meta: block-level analytics meta, sent as a JSON string
Events emitted:
emu-pagination:inview
emu-pagination:change