---
title: "Pagination"
description: "Numbered page buttons with previous/next controls, plus a divider-style load-more row."
---

Numbered page buttons with previous/next controls, plus a divider-style load-more row. Compose it from the exported registry parts so local content and behaviour stay in the application while the visual contract stays token-driven.

_Live example of Pagination — see the page for the rendered demo._

## Installation

```bash
npx newtui@latest add pagination
```

npm dependencies: class-variance-authority. Registry dependencies, installed with it: button.

Files written — React: components/ui/pagination.tsx. Vue: components/ui/pagination/Pagination.vue, components/ui/pagination/PaginationButton.vue, components/ui/pagination/PaginationEllipsis.vue, components/ui/pagination/LoadMore.vue, components/ui/pagination/index.ts.

## Usage

React:

```tsx
import { Pagination } from "@/components/ui/pagination"
```

Vue:

```ts
import { Pagination, PaginationButton, PaginationEllipsis, LoadMore } from "@/components/ui/pagination"
```

## API reference

**`Pagination`**

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children / default slot` | `React.ReactNode / Vue slot` | — | Content rendered inside the component. |
| `className / class` | `string` | — | Additional classes merged with the component defaults. |

The registry exports `Pagination`, `PaginationButton`, `PaginationEllipsis`, `LoadMore`. Parts without a table accept the native attributes for the element they render; React uses `className`, while Vue uses `class` and fallthrough attributes.

## Accessibility

Label the navigation region and mark the current page with `aria-current="page"`. Previous and next controls need descriptive accessible names.

## Tokens

Pagination reads its colours, radii and motion from the `--newt-*` tokens. Override a token rather than editing the component.