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
}}, as shown below:
The following objects can be used and accessed from any file in your theme, and are defined as global objects or global variables.
articles object can be used to retrieve an article using its
blogs object returns all the blogs in your store. More info ›
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 object returns your store's cart. More info ›
collections object returns all the collections in your store. More info ›
current_page object returns the number of the page a customer is on when browsing through paginated content. More info ›
current_tags object will return a different list of tags depending on the template that is being rendered. More info ›
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 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 object returns the handle of the page that is being viewed. More info ›
images object lets you access any image in your store by its filename. More info ›
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 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 object returns the title of the current page. More info ›
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.
shop object contains information about your store. More info ›
scripts object returns information about a store's active scripts.
To access information about a script, use the syntax
type is the script type. There can be only one active script of a particular type. Currently, the only script type is
To learn more about Shopify Scripts, visit the help content for the Shopify Scripts and the Script Editor .
settings object lets you access the settings of a store's published theme. More info ›
template object returns the name of the template that is being used to render the current page, not including its
.liquid file extension. As a best practice, it's recommended that you apply the template name as a CSS class on your HTML
<body> tag. More info ›
theme object returns the store's published theme. More info ›
The following objects are used to output the content of template and section files, as well as the scripts and stylesheets loaded by Shopify and Shopify apps.
content_for_header object is required in
theme.liquid. It must be placed inside the HTML
<head> tag. It dynamically loads all scripts required by Shopify into the document head. These scripts include Shopify analytics, Google Analytics, and scripts required for Shopify apps.
You shouldn't try to modify or parse the
content_for_header object. If
content_for_header changes, then the behavior of your Liquid will change. Modifications to
content_for_header can lead to broken analytics information within Shopify and other analytics programs with officially supported integration paths.
content_for_index object contains the content of dynamic sections to be rendered on the home page. This object must be included in
content_for_layout object is required in
theme.liquid. It must be placed inside the HTML
<body> tag. It dynamically loads content generated by other templates such as
Some Liquid objects are only used in specific circumstances.
true if a merchant's store has any payment providers with offsite checkouts, such as PayPal Express Checkout. Use
additional_checkout_buttons to check whether these gateways exist, and
content_for_additional_checkout_buttons to show the additional buttons. More info ›
Returns checkout buttons for any active payment providers with offsite checkouts. More info ›
content_for_additional_checkout_buttons are used in many Shopify themes: