Skip to content
Log in

Liquid drops reference — content and accounts

On this page

This article covers the Liquid drops for content (pages, articles, menus, content blocks), accounts and customers, locations, search, forms, and the PricebookEntryDrop.

Content drops

PageDrop

A content page. Available as current_page on content and home pages.

Property Type Description
id String Page ID
name String Page name
title String Page title
subtitle String Page subtitle
identifier String Page identifier
path String URL path
url String Full URL
body_content String Rendered page content (Liquid + Markdown evaluated)
content String Raw content (Liquid evaluated, no Markdown conversion)
plain_body_content String Body with Liquid evaluated but no Markdown conversion
content_blocks Collection Content blocks belonging to this page
meta_title String SEO title
meta_description String SEO description
meta_keywords String SEO keywords
social_image ImageDrop Social media sharing image
root_page PageDrop Top-level parent page
parent_page PageDrop Direct parent page
children Collection Child pages
navigation_children Collection Child pages visible in navigation
related_pages Collection Related pages
home_page? Boolean Is the store’s home page
hidden? Boolean Hidden from navigation
visible? Boolean Visible on the site
requires_login? Boolean Requires login to view
position Number Navigation position
search_keywords String Additional search keywords
data Hash Custom data fields

ArticleDrop

A blog article. Available as current_article on article detail pages.

Property Type Description
id String Article ID
title String Article title
subtitle String Article subtitle
author String Author name
identifier String Article identifier
path String URL path
url String Full URL
canonical_url String Canonical URL
body_content String Rendered body content (Liquid + Markdown evaluated)
introduction_content String Introduction HTML
summary_content String Summary HTML
hero_image ImageDrop Featured/hero image
social_image ImageDrop Social media sharing image
meta_title String SEO title
meta_description String SEO description
meta_keywords String SEO keywords
search_keywords String Additional search keywords
content_blocks Collection Associated content blocks
related_articles Collection Related articles
category ArticleCategoryDrop Article category
publish_on DateTime Publication date
published? Boolean Whether the article is published
requires_login? Boolean Requires login to view
data Hash Custom data fields

ArticleCategoryDrop

An article category. Available as current_article_category on article category pages.

Property Type Description
id String Category ID
name String Category name
identifier String Category identifier
path String URL path
url String Full URL
articles Paginated Articles in this category
data Hash Custom data fields

ContentBlockDrop

A structured content block. Accessed via all_content_blocks.identifier or as a page/article property.

Property Type Description
title String Block title
subtitle String Block subtitle
body String Block body content
identifier String Unique identifier
block_type String Block type (text, image, etc.)
image ImageDrop Associated image
images Collection Image collection
items Collection Content items
link_url String Link URL
link_text String Link text
css_class String Custom CSS class
data Hash Custom data fields

```liquid

{% assign hero = all_content_blocks.hero-banner %}

{{ hero.title }}

{{ hero.body }}

{{ hero.link_text }}

```

A navigation menu. Accessed via all_menus.identifier.

Property Type Description
identifier String Menu identifier
items Collection Top-level menu items

A navigation menu item.

Property Type Description
title String Display text
url String Link URL
items Collection Child menu items
active? Boolean Is the current page

```liquid

```

Account and customer drops

AccountDrop

A customer account. Available as current_account.

Property Type Description
id String Account ID
name String Account name
phone String Phone number
logo ImageDrop Account logo
active? Boolean Account is active
pay_by_account? Boolean Can use pay-by-account
credit_hold? Boolean Account is on credit hold
pricebook PricebookDrop Account-specific pricebook
membership MembershipDrop Associated membership
orders Collection Order history
account_credits Collection Account credits
account_points AccountPointsDrop Loyalty points
product_approvals Collection Product approvals
billing_street String Billing street address
billing_city String Billing city
billing_state String Billing state
billing_postal_code String Billing postal code
billing_country String Billing country
shipping_street String Shipping street address
shipping_city String Shipping city
shipping_state String Shipping state
shipping_postal_code String Shipping postal code
shipping_country String Shipping country
data Hash Custom data fields

ContactDrop

A customer/contact person. Available as current_customer.

Property Type Description
id String Contact ID
firstname String First name
lastname String Last name
name String Full name
email String Email address
username String Login username
phone String Phone
mobile_phone String Mobile phone
account AccountDrop Associated account
membership MembershipDrop Associated membership
has_login? Boolean Has a saved password
can_purchase_for_account? Boolean Can use pay-by-account
can_use_account_credit? Boolean Can use account credit
can_use_account_points? Boolean Can use account points
can_use_account_pricing? Boolean Can use account-specific pricing
orders Collection Order history
carts Collection Resumable carts
fulfillments Collection Fulfillments
subscriptions Collection Subscriptions
campaigns Collection Subscribed campaigns
mailing_street String Mailing street address
mailing_city String Mailing city
mailing_state String Mailing state
mailing_postal_code String Mailing postal code
mailing_country String Mailing country
last_login_date DateTime Last login timestamp
terms_accepted_on DateTime When terms were accepted
sso_provider String SSO provider name
data Hash Custom data fields

AccountCreditDrop

An account credit balance.

Property Type Description
balance Number Available credit
transactions Collection Credit transactions

AccountPointsDrop

Loyalty points balance.

Property Type Description
balance Number Available points
transactions Collection Points transactions

Search drops

SearchDrop

Search results and configuration. Available as current_search on product listing, category, and search pages.

Property Type Description
type String Search type: "products", "articles", "pages", or "locations"
term String Search query
count Number Total result count (before filters)
per_page Number Results per page
sort String Current sort applied
path String URL path to re-run this search
url String Full URL to re-run this search
results SearchResultDrop Search results grouped by type
fields Map Filter/sort fields available for this search

SearchResultDrop

Search results grouped by content type.

Property Type Description
products Paginated Product results
articles Paginated Article results
pages Paginated Page results
locations Paginated Location results

SearchFieldDrop

A search filter or sort field.

Property Type Description
name String Field name (used as URL parameter)
label String Display label
value String Current value
options Collection Available options
type String Field type

SearchFieldOptionDrop

An option for a search field.

Property Type Description
label String Display label
value String Option value
count Number Result count
selected? Boolean Currently selected

Location drops

LocationDrop

A physical store location. Available as current_location on location pages.

Property Type Description
id String Location ID
name String Display name
identifier String Unique identifier
path String URL path
url String Full URL
street String Street address
city String City
state String State/province
postal_code String Postal/ZIP code
country String Country
latitude Number GPS latitude
longitude Number GPS longitude
phone String Phone number
email String Email address
website String Website URL
logo ImageDrop Location logo
info_content String Information HTML
meta_title String SEO title
meta_description String SEO description
meta_keywords String SEO keywords
categories Collection Product categories this location handles
account AccountDrop Associated account
distance_in_kilometers String Distance from search point (in location search results)
distance_in_miles String Distance from search point (in location search results)
data Hash Custom data fields

LocationGroupDrop

A group of locations. Available as current_location_group on location group pages.

Form drops

Available inside {% form %} blocks.

FormDrop

Property Type Description
errors Array Validation errors
[field_name] FormFieldDrop Access any form field by name

FormFieldDrop

Property Type Description
name String HTML name attribute
value Any Current/default value
label String Human-readable label
id String HTML id attribute
errors Array Field-specific validation errors

FormErrorDrop

Property Type Description
field String Field name
messages Array Error messages
full_messages Array Error messages including the field name

PicklistOptionDrop

An option in a picklist field.

Property Type Description
label String Display label
value String Option value

PricebookEntryDrop

A product’s entry in a pricebook. Accessed via product.pricebook_entry.

Property Type Description
name String Pricebook name
entries Collection Price entries

Related articles

Documentation Liquid drops reference — global context and store Documentation Liquid drops reference — catalog Documentation Liquid drops reference — cart and order Documentation Liquid Objects Documentation Liquid forms reference

Was this article helpful?

Was this article helpful?