Skip to main content

Liquid variable reference guide

Written by Sam Forde

The following variables can be used when interacting with orders, email templates and SMS templates.


Available variables

Order variables

{{ name }}
{{ order_number }}
{{ shop.name }}
{{ formatted_created_at }}
{{ formatted_updated_at }}
{{ shipping_address.first_name }}
{{ shipping_address.last_name }}
{{ shipping_address.name }}

Attribute variables

Use order attribute variables unless you use the metafields only checkout widget.

{{ attributes.Checkout-Method }}
{{ attributes.Pickup-Location-Company }}
{{ attributes.Pickup-Location-Phone }}
{{ attributes.Pickup-Location-Address-Line-1 }}
{{ attributes.Pickup-Location-Address-Line-2 }}
{{ attributes.Pickup-Location-City }}
{{ attributes.Pickup-Location-Id }}
{{ attributes.Pickup-Location-Region }}
{{ attributes.Pickup-Location-Postal-Code }}
{{ attributes.Pickup-Location-Country }}
{{ attributes.Pickup-Date }}
{{ attributes.Pickup-Time }}
{{ attributes.Pickup-Day }}
{{ attributes.Pickup-Note }}
{{ attributes.Delivery-Date }}
{{ attributes.Delivery-Time }}
{{ attributes.Delivery-Note }}
{{ attributes.Delivery-Day }}
{{ attributes.Delivery-Location-Id }}
{{ attributes.Custom-Attribute-1 }}
{{ attributes.Custom-Attribute-2 }}
{{ attributes.Custom-Attribute-3 }}
{{ attributes.Shipping-Date }}
{{ attributes.Shipping-Day }}
{{ attributes.Shipping-Note }}

Metafield variables

Requirements

  • You need to be using the checkout widget and metafield only mode.
    Metafields are not added for the cart widget or checkout delivery options widget.

  • The metafields must have a default attribute value.

{{ metafields.zapiet.zapietAttributes.Checkout-Method | default: attributes.Checkout-Method }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Company | default: attributes.Pickup-Location-Company }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Phone | default: attributes.Pickup-Location-Phone }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Address-Line-1 | default: attributes.Pickup-Location-Address-Line-1 }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Address-Line-2 | default: attributes.Pickup-Location-Address-Line-2 }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-City | default: attributes.Pickup-Location-City }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Id | default: attributes.Pickup-Location-Id }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Region | default: attributes.Pickup-Location-Region }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Postal-Code | default: attributes.Pickup-Location-Postal-Code }}
{{ metafields.zapiet.zapietAttributes.Pickup-Location-Country | default: attributes.Pickup-Location-Country }}
{{ metafields.zapiet.zapietAttributes.Pickup-Date | default: attributes.Pickup-Date }}
{{ metafields.zapiet.zapietAttributes.Pickup-Time | default: attributes.Pickup-Time }}
{{ metafields.zapiet.zapietAttributes.Pickup-Day | default: attributes.Pickup-Day }}
{{ metafields.zapiet.zapietAttributes.Pickup-Note | default: attributes.Pickup-Note }}
{{ metafields.zapiet.zapietAttributes.Delivery-Date | default: attributes.Delivery-Date }}
{{ metafields.zapiet.zapietAttributes.Delivery-Time | default: attributes.Delivery-Time }}
{{ metafields.zapiet.zapietAttributes.Delivery-Note | default: attributes.Delivery-Note }}
{{ metafields.zapiet.zapietAttributes.Delivery-Day | default: attributes.Delivery-Day }}
{{ metafields.zapiet.zapietAttributes.Delivery-Location-Id | default: attributes.Delivery-Location-Id }}
{{ metafields.zapiet.zapietAttributes.Custom-Attribute-1 | default: attributes.Custom-Attribute-1 }}
{{ metafields.zapiet.zapietAttributes.Custom-Attribute-2 | default: attributes.Custom-Attribute-2 }}
{{ metafields.zapiet.zapietAttributes.Custom-Attribute-3 | default: attributes.Custom-Attribute-3 }}
{{ metafields.zapiet.zapietAttributes.Shipping-Date | default: attributes.Shipping-Date }}
{{ metafields.zapiet.zapietAttributes.Shipping-Day | default: attributes.Shipping-Day }}
{{ metafields.zapiet.zapietAttributes.Shipping-Note | default: attributes.Shipping-Note }}

Differentiate between pickup, delivery, and shipping

Attribute variables

If you want to display different content based upon the checkout method use the attributes.Checkout-Method

{% if attributes.Checkout-Method == "pickup" %}
This is a pickup order
{% endif %}
{% if attributes.Checkout-Method == "delivery" %}
This is a delivery order
{% endif %}
{% if attributes.Checkout-Method == "shipping" %}
This is a shipping order
{% endif %}

Metafield variables

If you want to display different content based upon the checkout method, you can use the checkout method metafield and attribute default.

{% assign checkoutMethod = metafields.zapiet.zapietAttributes.Checkout-Method | default: attributes.Checkout-Method %}
{% if checkoutMethod == "pickup" %} This is a pickup order {% endif %}
{% if checkoutMethod == "delivery" %} This is a delivery order {% endif %}
{% if checkoutMethod == "shipping" %} This is a shipping order {% endif %}

Did this answer your question?