# PaginatedList - Liquid Variable Source: https://support.storeconnect.com/articles/paginatedlist-variable-reference · Last modified 21 August 2026 ## Description A PaginatedList represents a server-side paginated collection of items. Unlike a regular List, records are fetched on-demand per page rather than loading all at once. Use the `{% paginate %}` tag to control page size and navigation. | Property | Value | |----------|-------| | **Type** | PaginatedList | | **String Representation** | `PaginatedList[ContentType]` | | **Index Access** | No (returns nil) | | **Key Lookup** | Yes (`list["key"]`) | ## Attributes | Attribute | Type | Description | |-----------|------|-------------| | `any?` | Boolean | Returns `true` if the PaginatedList contains at least one item | | `first` | Object | Returns the first item in the PaginatedList | | `last` | Object | Returns the last item in the PaginatedList | | `size` | Number | Returns the number of items in the PaginatedList | | `[]` | Object | Access items by key lookup (e.g. `list["slug"]`). Integer index access returns nil for paginated collections | | `each` | Iterator | Iterate over items on the current page using a `{% for %}` loop | ## Examples ### Paginating a PaginatedList ```liquid {% paginate collection.products by 12 %} {% for product in collection.products %}

{{ product.name }}

{% endfor %} {{ paginate | default_pagination }} {% endpaginate %} ``` ### Accessing by key ```liquid {{ pages["about-us"].name }} ``` ### Checking if the list has items ```liquid {% if collection.products.any? %} {{ collection.products.size }} products found {% endif %} ``` --- ## Follow StoreConnect - [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://getstoreconnect.com/partners) - [News](https://getstoreconnect.com/articles/news) - [Events](https://getstoreconnect.com/articles/events) - [Feature Comparison](https://getstoreconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://getstoreconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS --- StoreConnect Support — https://support.storeconnect.com/articles/paginatedlist-variable-reference