{"title":"PaginatedList - Liquid Variable","slug":"paginatedlist-variable-reference","url":"https://support.storeconnect.com/articles/paginatedlist-variable-reference","url_markdown":"https://support.storeconnect.com/articles/paginatedlist-variable-reference.md","subtitle":null,"summary":"Work with server-side paginated collections that fetch records per page instead of all at once. Use the paginate tag to control page size and navigate through large result sets.","type":"Developer_Documentation","video_url":"","keywords":"liquid, variables, PaginatedList, collection, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nA 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.\n\n| Property | Value |\n|----------|-------|\n| **Type** | PaginatedList |\n| **String Representation** | `PaginatedList[ContentType]` |\n| **Index Access** | No (returns nil) |\n| **Key Lookup** | Yes (`list[\"key\"]`) |\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `any?` | Boolean | Returns `true` if the PaginatedList contains at least one item |\n| `first` | Object | Returns the first item in the PaginatedList |\n| `last` | Object | Returns the last item in the PaginatedList |\n| `size` | Number | Returns the number of items in the PaginatedList |\n| `[]` | Object | Access items by key lookup (e.g. `list[\"slug\"]`). Integer index access returns nil for paginated collections |\n| `each` | Iterator | Iterate over items on the current page using a `{% for %}` loop |\n\n## Examples\n\n### Paginating a PaginatedList\n\n\n```liquid\n\n{% paginate collection.products by 12 %}\n  {% for product in collection.products %}\n    \u003cp\u003e{{ product.name }}\u003c/p\u003e\n  {% endfor %}\n\n  {{ paginate | default_pagination }}\n{% endpaginate %}\n```\n\n\n### Accessing by key\n\n\n```liquid\n\n{{ pages[\"about-us\"].name }}\n```\n\n\n### Checking if the list has items\n\n\n```liquid\n\n{% if collection.products.any? %}\n  {{ collection.products.size }} products found\n{% endif %}\n```\n"}