All guides

Guide

Shopify Liquid Cheat Sheet 2026

Pagination (paginate)

The paginate object is only available inside a {% paginate %} block, which splits large arrays such as collection products into pages.

01

{% paginate %} block

Wrap the loop in paginate and set the page size with by.

{% paginate collection.products by 12 %}
  {% for product in collection.products %}
    {{ product.title }}
  {% endfor %}
  {{ paginate | default_pagination }}
{% endpaginate %}
02

paginate.page_size

Number of items per page.

{{ paginate.page_size }}
03

paginate.current_page

The page number being viewed.

Page {{ paginate.current_page }} of {{ paginate.pages }}
04

paginate.current_offset

Number of items skipped before the current page.

{{ paginate.current_offset }}
05

paginate.pages

Total number of pages.

{{ paginate.pages }}
06

paginate.items

Total number of items across all pages.

{{ paginate.items }} products
07

paginate.previous / previous.title / previous.url

The previous page as a part object; nil on the first page.

{% if paginate.previous %}
  <a href="{{ paginate.previous.url }}">{{ paginate.previous.title }}</a>
{% endif %}
08

paginate.next / next.url

The next page as a part object; nil on the last page.

{% if paginate.next %}<a href="{{ paginate.next.url }}">Next</a>{% endif %}

Shopify experts

Let's talk ecommerce, Shopify & Shopify Plus solutions.

DROPSHIP HUBS helps ecommerce brands build, improve, and grow Shopify stores. We support new builds, migrations, ongoing development, SEO, and conversion optimisation.

Our team can help plan the right approach based on your store, goals, and current challenges.

Get in touch