---
title: "Pagination"
description: "The Pagination element displays page navigation for query results with customizable styling."
canonical: "https://academy.bricksbuilder.io/builder/elements/wordpress/pagination/"
markdownUrl: "https://academy.bricksbuilder.io/builder/elements/wordpress/pagination.md"
pageType: "article"
section: "builder"
category: "elements"
lastmod: "2026-05-21T13:58:32.000Z"
---
The Pagination element displays page navigation for query results with customizable styling.

## Settings

- **Query** (query-list) - Select which query this pagination controls.

- **Alignment** (justify-content) - Horizontal alignment of pagination links.

- **Height** (number with units) - Height of pagination buttons.

- **Width** (number with units) - Width of pagination buttons.

- **Spacing** (number with units) - Gap between pagination buttons. Default: 20px.

- **Background** (color) - Background color of pagination buttons.

- **Border** (border) - Border styling for pagination buttons.

- **Typography** (typography) - Font settings for pagination buttons.

### Current

- **Background** (color) - Background color of the current page button.

- **Border** (border) - Border styling for the current page button.

- **Typography** (typography) - Font settings for the current page button.

### Icons

- **Previous Icon** (icon) - Icon for the previous page button.

- **Next Icon** (icon) - Icon for the next page button.

### Miscellaneous

- **End Size** (number) - Number of page numbers shown at the start and end. Default: 1.

- **Mid Size** (number) - Number of page numbers shown on each side of current page. Default: 2.

:::tip[Developer reference]
See the [Pagination Schema](/developer/schema/elements/pagination/) for the full JSON schema of this element's settings and controls.
:::