# Liquid Variables Source: https://support.storeconnect.com/articles/liquid-variables · Last modified 21 August 2026 StoreConnect Liquid provides two collection variable types for working with sets of records. Both are iterable with a `{% for %}` loop and share a common set of attributes (`first`, `last`, `size`, `any?`), but they differ in how and when records are loaded. ## List A [List](list-variable-reference) loads all matching records into memory at once. It supports both integer index access (`list[0]`) and key lookup (`list["slug"]`), making it straightforward to work with when the full result set is small or already scoped by the page context. Use a List when: - The collection is already bounded (e.g. a product's variants, a cart's items) - You need random access by index or key - The total record count is manageable in memory ## PaginatedList A [PaginatedList](paginatedlist-variable-reference) fetches records server-side, one page at a time. Integer index access is not supported — only key lookup and iteration over the current page. Use it with the `{% paginate %}` tag to control page size and render navigation controls. Use a PaginatedList when: - The collection can grow large (e.g. a full product catalog, order history) - You need pagination controls in the template - Loading all records at once would hurt performance :::tip Most built-in collections exposed by Liquid objects (such as `collection.products`) are PaginatedLists. Wrap them in a `{% paginate %}` block to control how many records load per page. ::: ## Other variables in scope Beyond these collection types, a template can read variables that StoreConnect sets for you: - [Global variables](global-variables) — values present in every template, such as the current store, page, and request - [Liquid session variables](liquid-session-variables) — per-visitor state that persists across requests --- ## 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/liquid-variables