---
title: "Liquid tags: paginate"
description: Splits an array's items across multiple pages.
api_name: liquid
source_url:
html: https://shopify.dev/docs/api/liquid/tags/paginate
md: https://shopify.dev/docs/api/liquid/tags/paginate.md
---
# paginate
Splits an array's items across multiple pages.
Because [`for` loops](https://shopify.dev/docs/api/liquid/tags/for) are limited to 50 iterations per page, you need to use the `paginate` tag to iterate over an array that has more than 50 items. The following arrays can be paginated:
* [`article.comments`](https://shopify.dev/docs/api/liquid/objects/article#article-comments)
* [`blog.articles`](https://shopify.dev/docs/api/liquid/objects/blog#blog-articles)
* [`collections`](https://shopify.dev/docs/api/liquid/objects/collections)
* [`collection.products`](https://shopify.dev/docs/api/liquid/objects/collection#collection-products)
* [`customer.addresses`](https://shopify.dev/docs/api/liquid/objects/customer#customer-addresses)
* [`customer.orders`](https://shopify.dev/docs/api/liquid/objects/customer#customer-orders)
* [`pages`](https://shopify.dev/docs/api/liquid/objects/pages)
* [`product.variants`](https://shopify.dev/docs/api/liquid/objects/product#variants)
* [`search.results`](https://shopify.dev/docs/api/liquid/objects/search#search-results)
* [`collection_list` settings](https://shopify.dev/themes/architecture/settings/input-settings#collection_list)
* [`product_list` settings](https://shopify.dev/themes/architecture/settings/input-settings#product_list)
Within the `paginate` tag, you have access to the [`paginate` object](https://shopify.dev/docs/api/liquid/objects/paginate). You can use this object, or the [`default_pagination` filter](https://shopify.dev/docs/api/liquid/filters/default_pagination), to build page navigation.
## Syntax
```oobleckTag
{% paginate array by page_size %}
{% for item in array %}
forloop_content
{% endfor %}
{% endpaginate %}
The `paginate` tag allows the user to paginate to the 25,000th item in the array and no further. To reach items further in
the array the array should be filtered further before paginating. See
[Pagination Limits](/themes/best-practices/performance/platform#pagination-limits) for more information.
```
array
The array to be looped over.
page\_size
The number of array items to include per page, between 1 and 250.
item
An item in the array being looped.
forloop\_content
Content for each loop iteration.
```liquid
{% paginate collection.products by 5 %}
{% for product in collection.products -%}
{{ product.title }}
{%- endfor %}
{{- paginate | default_pagination }}
{% endpaginate %}
```
##### Code
```
{% paginate collection.products by 5 %}
{% for product in collection.products -%}
{{ product.title }}
{%- endfor %}
{{- paginate | default_pagination }}
{% endpaginate %}
```
##### Data
```
{
"collection": {
"products": [
{
"title": "Blue Mountain Flower"
},
{
"title": "Charcoal"
},
{
"title": "Crocodile tears"
},
{
"title": "Dandelion milk"
},
{
"title": "Draught of Immortality"
}
],
"products_count": 19
}
}
```
## Output
```html
Blue Mountain Flower
Charcoal
Crocodile tears
Dandelion milk
Draught of Immortality
1 2 3 4 Next »
```
### Paginating setting arrays
To allow the pagination of `product_list` and `collection_list` settings to operate independently from other paginated lists on a page, these lists use a pagination query parameter with a unique key. The key is automatically assigned by the `paginate` tag, and you don't need to reference the key in your code. However, you can access the key using [`paginate.page_param`](https://shopify.dev/docs/api/liquid/objects/paginate#paginate-page_param).
***
Tip
To paginate two arrays independently without refreshing the entire page, you can use the [Section Rendering API](https://shopify.dev/docs/api/ajax/section-rendering).
***
### Limit data fetching
The [`limit` parameter](https://shopify.dev/docs/api/liquid/tags/for#for-limit) of the `for` tag controls the number of iterations, but not the amount of information fetched. Using the `paginate` tag with a matching `page_size` can reduce the data queried, leading to faster server response times.
For example, referencing `collection.products` will fetch up to 50 products by default, regardless of the forloop's `limit` parameter. Use `paginate` and set a `page_size` to limit the amount of data fetched, and opt not to display any pagination controls.
More data than requested in a specific section may be returned. Because of this, make sure to include both `paginate` and `limit` when using this technique.
```liquid
{% paginate collection.products by 4 %}
{% for product in collection.products limit: 4 -%}
{{ product.title }}
{%- endfor %}
{% endpaginate -%}
{% for product in collection.products limit: 4 -%}
{{ product.title }}
{%- endfor -%}
```
##### Code
```
{% paginate collection.products by 4 %}
{% for product in collection.products limit: 4 -%}
{{ product.title }}
{%- endfor %}
{% endpaginate -%}
{% for product in collection.products limit: 4 -%}
{{ product.title }}
{%- endfor -%}
```
##### Data
```
{
"collection": {
"products": [
{
"title": "Blue Mountain Flower"
},
{
"title": "Charcoal"
},
{
"title": "Crocodile tears"
},
{
"title": "Dandelion milk"
}
],
"products_count": 19
}
}
```
## Output
```html
Blue Mountain Flower
Charcoal
Crocodile tears
Dandelion milk
Blue Mountain Flower
Charcoal
Crocodile tears
Dandelion milk
```
# paginate tag parameters
### window\_size
## Syntax
```oobleckTag
{% paginate collection.products by 3, window_size: 1 %}
```
Set the window size of the pagination. The window size is the number of pages that should be visible in the pagination navigation.
```liquid
{% paginate collection.products by 3, window_size: 1 %}
{% for product in collection.products -%}
{{ product.title }}
{%- endfor %}
{{- paginate | default_pagination }}
{% endpaginate %}
```
##### Code
```
{% paginate collection.products by 3, window_size: 1 %}
{% for product in collection.products -%}
{{ product.title }}
{%- endfor %}
{{- paginate | default_pagination }}
{% endpaginate %}
```
##### Data
```
{
"collection": {
"products": [
{
"title": "Blue Mountain Flower"
},
{
"title": "Charcoal"
},
{
"title": "Crocodile tears"
}
],
"products_count": 19
}
}
```
## Output
```html
Blue Mountain Flower
Charcoal
Crocodile tears
1 … 7 Next »
```