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.

Properties

Property	Type	Description
`store.name`	string	The store name
`store.description`	string	The store description
`store.url`	string	The full store URL
`store.email`	string	The contact email address
`store.phone`	string	The contact phone number

<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>

The store.brand object contains the store's visual identity: colours, logo, and social links. Use it to build headers, footers, and social sections that automatically update when the merchant changes their branding.

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 brief tagline or description
`store.brand.slogan`	string	The store slogan
`store.brand.colors`	object	Brand colour values
`store.brand.social_links`	array	Social media profile URLs

Brand colours

{% style %}
  :root {
    --brand-primary: {{ store.brand.colors.primary }};
    --brand-secondary: {{ store.brand.colors.secondary }};
  }
{% endstyle %}

{% 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. `£`)

<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.city`	string	City
`store.address.province`	string	County or state
`store.address.zip`	string	Postcode
`store.address.country`	string	Country

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

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