Template Tags and Variables¶

The Hello Retail Triggered Email templates use the open-source template language Liquid. You can find the Liquid reference here and, if you are new to Liquid, a Liquid for Designers guide here.

This article lists the variables available in Triggered Email templates.

The product tag and its variables¶

The product tag represents a product. It exposes fields such as the product title and price, along with other attributes. Available variables:

• title
• price
• url
• imgUrl
• isOnSale
• oldPrice
• currency
• inStock
• brand

Example:

<div>
   <h3>{{ product.title }}</h3>
   <img src="{{ product.imgUrl }}" /><br/>
   <span style="color:green;">{{ product.price }} {{ product.currency }}</span><br/>
   <div class="button"><a href="{{ product.url }}">Buy now!</a></div>
</div>

The products loop¶

The products variable contains the list of products provided by the trigger. Loop over it to render each product. Inside the loop, each product exposes the fields listed above.

Example: 

{% for product in products %}
<div>
  <h3>{{ product.title }}</h3>
  <img src="{{ product.imgUrl }}" /><br/>
  <span style="color:green;">{{ product.price }} {{ product.currency }}</span><br/>
  <div class="button"><a href="{{ product.url }}">Buy now!</a></div>
</div>
{% endfor %}

Additional variables available¶

firstProduct¶

The firstProduct variable returns the first product in products.

Use it in subject lines or opening paragraphs.

Example:

  {{ firstProduct.title }} among other products just dropped in price

mostPopularProduct¶

The mostPopularProduct variable returns the most popular product in the products list.

Useful for subject lines and key highlights.

Example:

Ups, you just left {{ mostPopularProduct.title }}
{% if products.size > 1 %}
   and {{ products.size|minus:1 }} more things behind you...
{% endif %}

mostExpensiveProduct¶

The mostExpensiveProduct variable returns the most expensive product in the products list.

Use it for subject lines or lead content.

Example:

{{ mostExpensiveProduct.title }} are now back in stock at only {{ mostExpensiveProduct.price }}

relatedProducts¶

When available, the relatedProducts variable is a list of related product objects.

Example:

{% if relatedProducts %}
  <h1>Related products</h1>
  {% for product in relatedProducts %}
    <div>
      <h3>{{ product.title }}</h3>
      <img src="{{ product.imgUrl }}" /><br/>
      <span style="color:green;">{{ product.price }} {{ product.currency }}</span><br/>
      <div class="button"><a href="{{ product.url }}">Buy now!</a></div>
    </div>
  {% endfor %}
{% endif %}

unsubscribe_url¶

The unsubscribe_url variable contains the system-generated unsubscribe link for the recipient.

Example:

<a href="{{ unsubscribe_url }}">Click here to unsubscribe!</a>

cart_total¶

The cart_total variable can be used on Abandoned Cart triggers when cart data is available.

Example:

{% if cart_total %}
  <strong>Total: {{ cart_total }}</strong>
{% endif %}

cart_url¶

The cart_url variable can be used on Abandoned Cart triggers when a recovery URL is available.

Example:

{% if cart_url %}
  <div class="button"><a href="{{ cart_url }}">Recover my cart</a>
{% endif %}