Skip to content
Design System
GitHub

Pagination

v0.15.0

Range and previous / next, or numbered pages, for long lists.

Pagination simple

Install
npx shadcn add @syncrobotic/pagination

Also installs: lucide-react, @syncrobotic/cn, @syncrobotic/button, @syncrobotic/filter-form

Overview

Where you are in a long list, and how to move through it.

When to use

  • Tables and lists with more rows than fit.

Use something else

  • A short list: show it all.
  • Finding one record: Command or a search field.

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

Pagination pages

Pagination compact

Pagination single page

Pagination empty

Pagination middle

Table rows

Pagination table footer

Usage rules

  • Say the range (1–10 of 48) so people know how much there is.
  • Previous and next disable at the ends. Numbered pages only for long lists people jump around in.
  • When the list is a page of its own, use href so each page is a URL: shareable, Back works, no JavaScript needed.
  • On a phone or in a gallery, prefer LoadMore: pages suit a desktop table, a growing list suits scrolling.

Changelog

  • 0.15.02026-11-19The range never wraps; in a container under 36rem the page numbers fold to previous, current and next.
  • 0.12.02026-11-18Link mode: href makes every page a link (?page=3), so it can be shared, Back works and it needs no JavaScript; onNavigate routes through the app's router. onPageChange is optional with href.
  • 0.8.02026-11-17First release.

How to upgrade