---
title: PaginationSize
description: Ensures that objects are paginated with performant sizes.
source_url:
  html: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size
  md: >-
    https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md
---

ExpandOn this page

* [Examples](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#examples)
* [Options](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#options)
* [Disabling this check](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#disabling-this-check)

# PaginationSize

Ensures that objects are [paginated](https://shopify.dev/docs/api/liquid/tags/paginate) with performant sizes so that too many objects aren't loaded at once. This helps to keep response times low.

***

## Examples

The following examples contain code snippets that either fail or pass this check.

### ✗ Fail

The following example includes a pagination size that leads to too many products on a single page, exceeding the [`max_size`](#options) value:

```liquid
{% paginate collection.products by 999 %}
```

### ✓ Pass

The following example includes a pagination size that will not negatively impact performance:

```liquid
{% paginate collection.products by 12 %}
```

***

## Options

```yaml
PaginationSize:
  enabled: true
  min_size: 1
  max_size: 50
```

| Parameter | Description |
| - | - |
| `enabled` | Whether this check is enabled. |
| `min_size` | The minimum valid pagination size. |
| `max_size` | The maximum valid pagination size. |

***

## Disabling this check

This check is safe to [disable](https://shopify.dev/docs/storefronts/themes/tools/theme-check/configuration).

***

* [Examples](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#examples)
* [Options](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#options)
* [Disabling this check](https://shopify.dev/docs/storefronts/themes/tools/theme-check/checks/pagination-size.md#disabling-this-check)