New pagination limits for Liquid & Storefront GraphQL API

Changelog
1

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

This is a companion discussion topic for the original entry at https://shopify.dev/changelog/new-pagination-limits-for-liquid-storefront-graphql-api
2

We are still not able to use the pagination liquid tag to get more than 250 of product.variants. There all return 250 variants

{% paginate product.variants by 400 %}

{% paginate product.variants by 3000 %}

Can you clarify how we can get more than 250 variants on a single product page with liquid using pagination?

3

Hey @Jung-Shan_Lee, when working with product variants, this guide will help out: Support high-variant products

To prevent poor render performance in themes, we’ve restricted product.variants to return a maximum of 250 variants and added APIs to solve common use cases that previously required loading all variants. To prepare for increased variant limits, audit your theme for any code that might rely on all product variants to be present.

1 Like
4

I think 250 variants is quite a lot. You always have the opportunity to fetch the rest and append it asynchronous.

1 Like
5

You can’t lift the 250-variant cap in Liquid for product.variants.

That changelog’s 25,000-item limit applies to general array pagination, but variants are explicitly restricted in themes for render performance. Liquid will surface at most 250 variants total, and even with {% paginate %} you’re limited to 50 per page within that 250. (Support high-variant products) (product)

If you need to expose more than 250 on a product page, fetch them outside Liquid. The recommended path is Storefront GraphQL (Product.variants connection with cursor pagination), then hydrate your UI via AJAX or the Section Rendering API so you only render what’s needed.

The “Support high-variant products” guide walks through those patterns and alternatives like variant pickers without loading everything at once.

1 Like