---
title: >-
  New pagination limits for Liquid & Storefront GraphQL API - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/new-pagination-limits-for-liquid-storefront-graphql-api
  md: >-
    https://shopify.dev/changelog/posts/new-pagination-limits-for-liquid-storefront-graphql-api.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Liquid
      handle: liquid
    - displayName: Storefront API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: false
  createdAt: '2025-06-16T15:49:15-04:00'
  postedAt: '2025-06-17T12:00:00-04:00'
  updatedAt: '2025-06-17T09:27:25-04:00'
  effectiveAt: '2025-06-17T12:00:00-04:00'
---

June 17, 2025

# New pagination limits for Liquid & Storefront GraphQL API

DateJune 17, 2025

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)

SurfacesAPI

Affected APIs[Liquid](https://shopify.dev/changelog?api_type=liquid)[Storefront API](https://shopify.dev/changelog?api_type=storefront-graphql)

## What's changing

The Liquid and Storefront GraphQL API now limits pagination of arrays of objects to 25,000 items. This affects:

* For paginated GraphQL queries (using `first`, `last`, `before`, `after` parameters), queries will now return an error when paginating past the 25,000th item in the array.
* For uses of the `paginate` tag in Liquid, the last allowed page will be returned when paginating past the 25,000th item in the array.
* Any query originating from Liquid or GraphQL for a count will now return a maximum of 25,001 (indicating "more than 25,000") for arrays with more items.

In addition to that:

* The maximum Liquid page size has been increased from 50 to 250 to match the Storefront GraphQL API limit.

The documentation for [Liquid](https://shopify.dev/docs/storefronts/themes/best-practices/performance/platform#pagination-limits) and [API usage](https://shopify.dev/docs/api/usage/limits#pagination-limits) have been updated to reflect these limits.

**Important:** This change only affects the Liquid and Storefront GraphQL API. The Admin GraphQL API continues to support higher limits for merchant facing workflows. See recent changelogs to that effect [here](https://shopify.dev/changelog/enhanced-variant-query-limits-for-single-product-queries) and [here](https://shopify.dev/changelog/uncapped-graphql-counts).

## What you need to do

If your application, storefront, or Liquid theme paginates through more than 25,000 items:

* Add filters to views to help narrow down results before pagination. For example, filter by product type, price range, or availability.
* Update count handling to account for the 25,001 maximum return value and replace it with a human readable value like "More than 25,000 products available."