Liquid objects

Liquid objects contain attributes to output dynamic content on the page. For example, the product object contains an attribute called title that can be used to output the title of a product.

Liquid objects are also often referred to as Liquid variables.

To output an object's attribute, wrap the object's name in {{ and }}, as shown below:

Global objects

The following objects can be used and accessed from any file in your theme, and are defined as global objects or global variables.

all_products

The all_products object contains a list of all the products in your store. You can use all_products to access products by their handles. More info ›

articles

The articles object can be used to retrieve an article using its handle.

blogs

The blogs object returns all the blogs in your store. More info ›

canonical_url

The canonical_url object returns the canonical URL for the current page. The canonical URL is the page's "default" URL with any URL parameters removed.

For products and variants, the canonical URL is the default product page with no collection or variant selected. For example, for a product in a collection with a variant selected:

The canonical URL is the product page:

Google's Search Console Help provides more information on canonical URLs.

cart

The cart object returns your store's cart. More info ›

collections

The collections object returns all the collections in your store. More info ›

current_page

The current_page object returns the number of the page a customer is on when browsing through paginated content. More info ›

current_tags

The current_tags object will return a different list of tags depending on the template that is being rendered. More info ›

customer

The customer object returns the customer that is logged in to the store. It will not return anything if a customer isn't logged in. More info ›

linklists

The linklists object returns the set of the menus and links in your store. You can access a menu by calling its handle on the linklists object. More info ›

handle

The handle object returns the handle of the page that is being viewed. More info ›

images

The images object lets you access any image in your store by its filename. More info ›

pages

The pages object returns a list of all the pages in your store. More info ›

You can return properties for a specific page using ``:

You can also interate through up to 50 pages at a time with pagination:

page_description

The page_description object returns the description of the product, collection, or page that is being rendered. Descriptions for these items can be set in your Shopify admin. More info ›

page_title

The page_title object returns the title of the current page. More info ›

recommendations

The recommendations object returns product recommendations that are related to a given product, based on data from sales, product descriptions, and relations between products and collections.

To show the section, you must make the request using JavaScript and insert the response's HTML on the page. More info ›

shop

The shop object co