> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Pagination Component

## Article: Pagination Component

## Article Link: https://dev.wix.com/docs/wix-design-system/components/navigation/pagination-component.md

## Article Content:

# Pagination

_Components/Navigation_

Interactive docs page: <https://wix-pages.com/design-system-documentation/#/component/pagination>

## Overview

```jsx
() => {
  const [currentPage, setCurrentPage] = React.useState(3);

  return (
    <Box align="center">
      <Pagination
        onChange={(e) => setCurrentPage(e.page)}
        currentPage={currentPage}
        totalPages={5}
      />
    </Box>
  );
};
```

Pagination splits up large amounts of content into multiple pages.

### Do

- Use it to let users navigate between content on multiple pages.
- Use it to show small chunks of content at a time.

### Don't

- Don't use it to navigate between content on the same page. Use `<Tabs/>` instead.
- Don't use it to illustrate progress in a task or process. Use `<Stepper/>` instead.

### Feature examples

#### Number of pages

Control the total number of pages available with the `totalPages` prop.

This number starts from two and has no maximum value.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Pagination currentPage={1} totalPages={2} />
  <Pagination currentPage={1} totalPages={10} />
</StorybookComponents.Stack>;
```

#### Current page

Specify which page is currently selected with the `currentPage` prop.

The first page will be selected, if not specified otherwise.

```jsx
<StorybookComponents.Stack flexDirection="column">
  <Pagination currentPage={1} totalPages={16} />
  <Pagination currentPage={8} totalPages={16} />
  <Pagination currentPage={16} totalPages={16} />
</StorybookComponents.Stack>;
```

## Code

```jsx
import { Pagination } from '@wix/design-system';
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `currentPage` | `number` | `1` | Specifies a currently selected page. |
| `dataHook` | `string` | — | Applies a data-hook HTML attribute that can be used in the tests. |
| `disabled` | `boolean` | — |  |
| `nextLabel` | `string` | — | Sets next page label. |
| `onBlur` | `(event: FocusEvent, triggers: Triggers) => void` | — |  |
| `onChange` | `(event: { event: SyntheticEvent<Element, Event>; page: number; }) => void` | — | Defines a callback function which returns a selected page or an arrow ({`event`,`page`}) |
| `onFocus` | `(event: FocusEvent, triggers: Triggers) => void` | — |  |
| `pageUrl` | `(pageNumber: number) => string` | — | Get pageNumber and returns url. |
| `previousLabel` | `string` | — | Sets previous page label. |
| `ref` | `RefObject` | — |  |
| `totalPages` | `number` | — | Sets a number of available pages to show in the component. |

## Testkit

Import the driver matching your test environment:

```jsx
// UniDriver
import { PaginationUniDriver } from '@wix/design-system/dist/testkit/unidriver';

// Vanilla
import { PaginationTestkit } from '@wix/design-system/dist/testkit';

// Puppeteer
import { PaginationTestkit } from '@wix/design-system/dist/testkit/puppeteer';

// Testing Library
import { PaginationTestkit } from '@wix/design-system/dist/testkit/testing-library';
```

### Driver methods

| Method | Description |
| --- | --- |
| `isVisible` | Check if element is rendered |
| `getCurrentPage` | Returns currently selected page |
| `getTotalPages` | Returns a total amount of pages available |
| `clickOnPage` | Clicks on gives page number |
| `clickNextButton` | Clicks on next button |
| `clickPreviousButton` | Clicks on previous button |
| `exists` | Checks whether the component found with the given data hook. |
| `element` | Gets the component root element. |
| `click` | Clicks on the component root element. |
| `base` | Returns UniDriver for the base element. |

## Changelog

- **1.339.0** (2026-10-19) — maintenance release, no component-specific changes
- **1.338.0** (2026-10-15) — maintenance release, no component-specific changes
- **1.330.0** (2026-09-28) — maintenance release, no component-specific changes
- **1.329.0** (2026-09-24) — maintenance release, no component-specific changes
- **1.325.0** (2026-09-17) — maintenance release, no component-specific changes
- **1.323.0** (2026-09-10) — maintenance release, no component-specific changes
- **1.310.0** (2026-08-10) — maintenance release, no component-specific changes
- **1.292.0** (2026-06-22) — maintenance release, no component-specific changes
- **1.290.0** (2026-06-18) — fix: harmony dark current page background and arrow fill token ([#16412](invalid-url)) — has visual changes
- **1.278.0** (2026-05-08) — maintenance release, no component-specific changes
- **1.273.0** (2026-04-30) — maintenance release, no component-specific changes
- **1.271.0** (2026-04-22) — maintenance release, no component-specific changes
- **1.266.0** (2026-04-07) — maintenance release, no component-specific changes
- **1.260.0** (2026-03-17) — maintenance release, no component-specific changes
- **1.254.0** (2026-02-03) — maintenance release, no component-specific changes
- **1.250.0** (2026-01-27) — maintenance release, no component-specific changes
- **1.212.0** (2025-08-11) — maintenance release, no component-specific changes
- **1.165.0** (2025-02-27) — maintenance release, no component-specific changes
- **1.155.0** (2025-01-23) — maintenance release, no component-specific changes
- **1.138.1** (2024-10-30) — maintenance release, no component-specific changes
- **1.115.0** (2024-07-17) — maintenance release, no component-specific changes
- **1.102.0** (2024-04-16) — maintenance release, no component-specific changes
- **1.98.0** (2024-03-15) — maintenance release, no component-specific changes
- **1.93.0** (2024-02-08) — maintenance release, no component-specific changes
- **1.92.1** (2024-02-05) — maintenance release, no component-specific changes