Store

The store object holds information about the shop itself. It is available on every page. Use it for headers, footers, and anywhere you need the store name, logo, or contact details.

Core properties

Property	Type	Description
`store.name`	string	The store name
`store.description`	string	The store description
`store.url`	string	The full store URL (e.g. `https://www.mystore.com`)
`store.domain`	string	The primary domain (e.g. `www.mystore.com`)
`store.email`	string	The contact email address
`store.phone`	string	The contact phone number
`store.locale`	string	The store's default locale (e.g. `en`)

<footer>
  <p>&copy; {{ 'now' | date: '%Y' }} {{ store.name }}</p>
  <p>{{ store.email }}</p>
</footer>

Branding

Property	Type	Description
`store.logo`	string	The logo URL

<header>
  {% if store.logo %}
    <img src="{{ store.logo }}" alt="{{ store.name }}" />
  {% else %}
    <h1>{{ store.name }}</h1>
  {% endif %}
</header>

Brand identity

The store.brand object has the store's look and feel. Use it in headers, footers, and social links. It stays in sync when the store owner makes changes.

Property	Type	Description
`store.brand.logo`	image	The brand logo
`store.brand.cover_image`	image	The brand cover image
`store.brand.short_description`	string	A short tagline
`store.brand.slogan`	string	The store slogan
`store.brand.colors`	object	Brand color values
`store.brand.social_links`	array	Social media profile URLs

{% if store.brand.slogan %}
  <p class="tagline">{{ store.brand.slogan }}</p>
{% endif %}

{% for link in store.brand.social_links %}
  <a href="{{ link.url }}" target="_blank">{{ link.title }}</a>
{% endfor %}

Currency

Property	Type	Description
`store.currency`	string	The currency code (e.g. `GBP`)
`store.currency_symbol`	string	The currency symbol (e.g. `£`)
`store.money_format`	string	The money format pattern (e.g. `£{{amount}}`)

<p>All prices are in {{ store.currency }} ({{ store.currency_symbol }})</p>

You rarely need these directly. The money filter handles formatting for you. But they are useful for showing a currency notice in the footer or for passing data to JavaScript.

Address

Property	Type	Description
`store.address`	object	The store's physical address
`store.address.address1`	string	Street line 1
`store.address.address2`	string	Street line 2
`store.address.street`	string	Combined street lines
`store.address.city`	string	City
`store.address.province`	string	County, state, or province
`store.address.province_code`	string	Province abbreviation
`store.address.zip`	string	Postal code
`store.address.country`	string	Country
`store.address.country_code`	string	Country ISO code

<address>
  {{ store.address.address1 }}<br />
  {{ store.address.city }}, {{ store.address.zip }}<br />
  {{ store.address.country }}
</address>

Catalog info

Property	Type	Description
`store.products_count`	number	Total number of products in the store
`store.collections_count`	number	Total number of collections
`store.types`	array	All unique product types in the store
`store.brands`	array	All unique brand names in the store

<p>Browse {{ store.products_count }} products across {{ store.collections_count }} collections</p>

Store configuration

These fields show how the store is set up. Use them to show or hide parts of the page based on the store's plan or mode.

Property	Type	Description
`store.plan`	string	The store's plan: `free`, `pro`, or `ecom`
`store.tax_inclusive`	boolean	`true` if displayed prices include tax
`store.payment_provider`	string	`stripe`, `airwallex`, or `none`
`store.target_markets`	array	Country codes the store ships to
`store.pricing_mode`	string	`standard`, `member_teaser`, or `member_only`

{% if store.tax_inclusive %}
  <p>All prices include VAT</p>
{% else %}
  <p>Prices exclude tax, calculated at checkout</p>
{% endif %}

Feature flags

The store.features object contains toggles for optional features:

Property	Type	Description
`store.features.pricing_b2c`	boolean	Retail pricing is enabled
`store.features.pricing_b2b`	boolean	Wholesale pricing is enabled
`store.features.pricing_catalogue`	boolean	Catalog mode (no prices shown)

{% if store.features.pricing_b2b and customer.tier == 'wholesale' %}
  <p>Trade pricing applied</p>
{% endif %}

Metafields

Property	Type	Description
`store.metafields`	object	Custom data fields set in the admin

Store metafields are a good place to put global data that does not fit in the standard fields:

{% if store.metafields.custom.announcement %}
  <div class="announcement-bar">
    {{ store.metafields.custom.announcement }}
  </div>
{% endif %}

On this page