> For the complete documentation index, see [llms.txt](https://docs.woohoo.dance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.woohoo.dance/ajax-filters/elements/ajax-pagination.md).

# Ajax Pagination

**Navigate through multiple pages of results.**

Cannot be used with Infinite Scroll or Load More on the same query.

**Content Settings**

| Setting                | Description                          |
| ---------------------- | ------------------------------------ |
| **Query Name**         | Must match your Main Query           |
| **Button Type**        | Text only, Icon only, or Text & Icon |
| **Previous/Next Text** | Labels for navigation buttons        |
| **Previous/Next Icon** | Icons for navigation buttons         |
| **Icon Style**         | Size and color                       |
| **Icon Position**      | Left or Right of text                |

**Design Settings**

* Layout: Width, spacing, alignment (left/center/right), margin
* Button: Padding, background, borders, typography, shadows
* Hover/Active states with full customization
* Transition duration

**Features**

* Smart ellipsis for many pages (1 ... 5 6 7 ... 20)
* Previous/Next buttons auto-disable at boundaries
* Smooth scroll to top of results on page change
* URL updates with page number for shareable links
