Pagination

Use GdsPagination when users need to move through a known number of pages. It wraps MUI Pagination and uses GDS theme tokens for standard and primary pagination item states.

Pagination starts at page 1. Use count for the total number of pages, and use page with onChange when the selected page is controlled by application state.

Default

Colors

GDS supports standard and primary pagination colors.

Variants

Use text for the default low-emphasis pagination style. Use outlined when the pagination items need stronger boundaries.

Sizes

Pagination supports MUI’s small, medium, and large sizes.

First and Last Buttons

Use showFirstButton and showLastButton when users need to jump quickly to the beginning or end of a long result set.

Props