Skip to content

Official government website An official website of the Federal Government of Nigeria

How you know
Federal Ministry of Communications, Innovation & Digital Economy Nigerian Design Standards

Pagination

Lets people move through a long list that is split into pages, such as search results, news or publications.

Added · New

Live example

Pagination
Controls
Property Control What it does
Numbered, Previous and next, or Table (under a data table).
Mobile shows first, current and last pages, with arrow-only Previous and Next.
Filled and marked aria-current="page". Previous is hidden on page 1, Next on the last page.

Overview

Put pagination after a long list, left aligned with it. It shows where people are in the list and lets them move to other pages.

Use pagination for

  • Lists longer than about 20 items
  • Search results, news and publications
  • Lists people come back to, or share a page of

Don’t use pagination for

  • Lists that fit on one page (show them all)
  • Steps in a form (use Continue and Back)
  • Next and previous article on a content page

Examples

Three types, each with a desktop and a mobile version. The mobile versions are shown here: first, current and last pages only.

Numbered

First, current and last pages, with arrow-only Previous and Next: 1 … 7 … 20. On desktop, one page either side of the current one.

Previous and next

No numbers. “Page 7 of 20” between the links. For feeds and news, when the order matters more than the position.

Table

Under a data table. The count and rows per page sit on one line, with the pager below. On desktop they share one line with the pager.

Specifications

The properties of pagination. The same in HTML and React.

Pagination properties
Property Type Possible values Description
currentPage number
  • 1 – totalPages
Required. The page shown. Filled and marked aria-current="page".
totalPages number
  • 1 or more
Required for Numbered. Hide pagination when there is only one page.
type string
  • "numbered"
  • "prev-next"
  • "table"
Optional. Defaults to "numbered".
hrefTemplate string
  • ?page={n}
Required. Keeps the page in the URL, so links and the back button work.
rowsPerPage number
  • 10
  • 25
  • 50
  • 100
Table only. Defaults to 10. Changing it goes back to page 1 and keeps the sort.

In code, pagination is a <nav aria-label="Pagination"> after the list, with a <ul>. Each page is <a href="?page=6" aria-label="Page 6">. The current page is <a aria-current="page">. Previous and Next use rel="prev" and rel="next"; on small screens the word is visually hidden but still read. The ellipsis is <li aria-hidden="true">. Hide Previous on the first page and Next on the last; never show them disabled.

Tokens

Pagination tokens and contrast
Part Token Contrast on the page
Page number Body/medium · text/primary · 40×40 (spacing/500) 17.6:1
Current page Body/medium-emphasized · brand/900 on action/primary/subtle 13.1:1
Previous / Next Body/medium · text/primary · size/icon/md arrows · spacing/100 gap 17.6:1
Ellipsis and status Body/small · text/secondary 6.6:1
Hover action/tertiary/hover tint, underlined Decorative
Spacing spacing/150 side padding · spacing/050 between items · radius/050 —
Focus Focus ring (border/focus), on :focus-visible —

Use cases

Do

Hide Previous on the first page and Next on the last. Show the first, current and last pages, with … for gaps.

Don’t

Don’t show Previous or Next greyed out, and don’t put pagination only at the top of the list. Put it after the list, where people finish reading.

Layout

Where pagination goes and which pages it shows.

After the list, left aligned

Directly under it, the same width. One pager per list.

Result count above the list
“Showing 61–70 of 196 results”.
Page in the URL
?page=7, so links and the back button work.
7 pages or fewer: every number
No ellipsis.
“…” for gaps of 2 or more

If the gap is exactly 1 page, show the number: 1 2 3 4 … 20.

Copywriting

How to word the controls and the count.

Say “Previous” and “Next”

Not “Back”, “Older” or « on its own. The arrow is extra.

Name each page

aria-label “Page 6”, so screen readers say more than a number.

Show the range
“Showing 61–70 of 196 results”, above the list.
Status in words
“Page 7 of 20” for Previous and next.
Update the page title
“Search results, page 7 of 20”.
Label rows per page
“Rows per page”, with 10, 25, 50 and 100.

Examples

Pagination copywriting examples
Write Don’t write Why
Previous « Prev Plain words, not symbols on their own.
Page 7 of 20 7/20 Read clearly by screen readers.
Showing 61–70 of 196 results Results Says where people are in the list.
Next is hidden on the last page Next shown greyed out A disabled link is a dead end.
Search results, page 7 of 20 Search results The page title says which page people are on.

Accessibility

Pagination is a named navigation landmark. After a page change, focus moves to the result count or list heading, not the bottom of the new page.

Keyboard interaction for pagination
Key What it does
Tab Moves through Previous, the page numbers and Next, left to right. The ellipsis is skipped.
Shift + Tab Moves back.
Enter Goes to that page. Focus moves to the result count or list heading.
  • <nav aria-label="Pagination"> after the list. A second pager on the same page gets a different label (WCAG 1.3.1, 2.4.1).
  • The current page has aria-current="page" and is filled and heavier, not only a colour change (WCAG 1.4.1, 4.1.2).
  • Each link has a name, “Page 6”, and Previous and Next keep their words in code on small screens (WCAG 2.4.4, 2.5.3).
  • After a page change, focus moves to the count or heading and the page title is updated (WCAG 2.4.2, 2.4.3).
  • Current page 13.1:1, numbers 17.6:1. Targets are 40×40, 44px on mobile; the table count is a polite live region (WCAG 1.4.3, 2.5.8, 4.1.3).

For developers

Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed under Specifications.

For designers

Use Pagination from 01 Library – Foundations. Pick Numbered, Previous and next or Table, and Desktop or Mobile. Change the page numbers with Pagination item. Don’t detach it.

References

Feedback

Report a problem with this page