Template Tags and Variables

The Hello Retail Triggered email templates are based on the open-source template language called Liquid. You can find a great reference for Liquid here and if you are new to Liquid, you can find a great resource for designers here.

In this article, you'll find an overview of the variables available in the Triggered email templates.

The product tag and it's variables

The product tag is a representation of a product. On a product, stuff like the product title and price are available among other variables. Here's the complete list of variables available:

• title
• price
• url
• imgUrl
• isOnSale
• oldPrice (Note: only available if isOnSale is true)
• 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 is the main variable containing the list of products to loop over, for you to display. Inside this loop, you have access to the product with the details specified 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 is simply a shortcut returning one and the first product available.

This can be great to use in subject lines and opening paragraphs in your Triggered emails.

Example:

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

mostPopularProduct

The mostPopularProduct variable is a shortcut to the most popular product available in the products list.

This variable can be used with great success in subject lines of your Triggered emails.

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 is a shortcut to the most expensive product available in the products list.

This can be great to use in subject lines and opening paragraphs in your Triggered emails.

Example:

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

relatedProducts

If available, the relatedProducts variable is a list of products.

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 is a variable containing your unique system URL for users to click if they wish to unsubscribe.

Example:

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

cart_total

The cart_total variable can be used on Abandoned cart triggers, if available.

Example:

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

cart_url

The cart_url variable can be used on Abandoned cart triggers, if available.

Example:

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