# Pagination

> Pagination controls with previous, next, and page links.

Registry name: `pagination`. HTML docs: https://ui.anuragroy.dev/component/pagination.

## Install

```bash
npx shadcn@latest add https://ui.anuragroy.dev/r/pagination.json
```

If the website is down: `npx shadcn@latest add https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/pagination.json`.

Registry JSON: https://ui.anuragroy.dev/r/pagination.json (GitHub: https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/pagination.json).

## Import

Import paths follow the consumer `components.json` aliases. After a default install:

```tsx
import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious
} from "@/components/ui/pagination"
```

## Usage

```tsx
import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"

export function Example() {
  return (
    <Pagination>
      <PaginationContent>
        <PaginationItem>
          <PaginationPrevious href="#" />
        </PaginationItem>
        <PaginationItem>
          <PaginationLink href="#" isActive>1</PaginationLink>
        </PaginationItem>
        <PaginationItem>
          <PaginationEllipsis />
        </PaginationItem>
        <PaginationItem>
          <PaginationNext href="#" />
        </PaginationItem>
      </PaginationContent>
    </Pagination>
  )
}
```

## API

### PaginationLink

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `isActive` | boolean | — |  |
| `size` | Button size | — | Forwards to the underlying button styles. |
| `href` | string | — |  |

## See also

- [HTML page](https://ui.anuragroy.dev/component/pagination): Preview and the same docs in the site chrome.
- [Registry item](https://ui.anuragroy.dev/r/pagination.json): Source files and dependencies.
- [Catalog](https://ui.anuragroy.dev/component): All components.
- [llms.txt](https://ui.anuragroy.dev/llms.txt): Agent index for this library.