# Pagination

## Block limitations

This is a private block and can only be used within specific parent blocks. It is designed to work exclusively within paginated layout blocks.

## Overview

A pagination component that provides options for infinite scroll, load more button, and numbered page navigation within paginated content.

## Common use cases

* Use within paginated collections or search results
* Choose pagination type based on user experience needs

## Block settings

| Setting              | Description                            | Options                                                                                                                           |
| -------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Pagination type      | Type of pagination to display          | Scroll (default), Load, Pages                                                                                                     |
| Label                | Custom label for load more button      | Text input                                                                                                                        |
| Show page count      | Displays current page and total pages  | Checkbox (default: true)                                                                                                          |
| Top spacing          | Spacing above the pagination           | 0 - 300 px (default: 0)                                                                                                           |
| Bottom spacing       | Spacing below the pagination           | 0 - 300 px (default: 0)                                                                                                           |
| Enable padding       | Adds padding around the pagination     | Checkbox (default: true)                                                                                                          |
| Color scheme         | Controls the background color scheme   | Body, Neutral, Accent 1, Accent 2, Accent 3, Shade 1, Shade 2, Shade 3, Primary, Secondary, Tertiary, Blur, Transparent (default) |
| Border color         | Controls the border color              | Body, Subtle (default), Strong, Primary, Secondary, Tertiary, None. Visible when border position is not empty                     |
| Button color         | Color style for pagination buttons     | Primary, Secondary (default), Tertiary, Neutral, Plain, Outline, Inverted outline, Blur, Link, Inverted link                      |
| Border position      | Controls which sides have borders      | None (default), Top, Bottom, Left, Right, Top and bottom, Left and right, All                                                     |
| Button size          | Size of pagination buttons             | Extra small, Small (default), Standard, Large                                                                                     |
| Horizontal alignment | Controls horizontal alignment          | Left, Center (default), Right                                                                                                     |
| Sticky position      | Makes the pagination stick to viewport | None (default), Top, Bottom                                                                                                       |
| Visibility           | Controls when the block is visible     | All (default), Mobile only, Desktop only                                                                                          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.brickspacelab.com/slab/content/blocks/navigation/pagination.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.