Skip to content
Design System
  • Home
  • Settings
  • Styles
  • Layouts
  • Components
  • Scripts
  • Templates
  • Access control banner
  • Activity
  • Archived content
  • Breadcrumbs
  • Cards
  • Collapsible containers
  • Columns
  • Content slider (carousel)
  • Crosslinks (You may also like)
  • Disclosure button
  • Evangelists
  • Fifty-fifty
  • Footer
  • Group list
  • Header
  • Hero
  • Image component
  • Members
  • Navigation
  • Navigation with new logo v1
  • Navigation with new logo v2
  • Notes
  • Pagination
  • Pre-footer
  • Quote component
  • RSS
  • Table of contents
  • Tag list
  • Text component
  • Translations
  • Video component

Pagination

Used on various listing pages.

Open this Pagination in a new tab

HTML:

<nav class="l-cluster pagination" aria-labelledby="pagination">
    <h2 id="pagination" class="visuallyhidden">Pagination</h2>
	<ul class="pagination__list">
		<li><a href="path/to/page">Previous</a></li>
		<li><a class="pagination__list__first" href="path/to/page"> 1</a></li>
		<li><a class="ellipsis">&#8230;</a></li>
		<li><a href="path/to/page">6</a></li>
		<li><a href="path/to/page">7</a></li>
		<li><a href="#" aria-current="page">8</a></li>
		<li><a href="path/to/page">9</a></li>
		<li><a href="path/to/page">10</a></li>
		<li><a class="ellipsis">&#8230;</a></li>
		<li><a class="pagination__list__last" href="path/to/page">20</a></li>
		<li><a href="path/to/page">Next</a></li>
	</ul>
</nav>

¶Considerations

Note the use of the cluster layout.

The aria-labelledby attribute has been added to the <nav> element, which references the ID of the visually-hidden <h2> inside the <nav>. This is because the main website navigation also uses the <nav> element. Where there are multiple <nav> elements on a single page, they should all have a unique accessible name.

The current page is indicated by aria-current="page". As per the breadcrumbs component, it is fully linked so that users of Assistive Technology can find which is the currently active link.

Copyright © 2025 W3C - generated 10 Jan 2025, 12:43:28 UTC

Feedback is welcome and can be submitted as a GitHub issue.