You can use variables in your email notifications and Thank you page. Variables allow the output of dynamic content depending on the content of the orders or the attributes of a customer.

This guide outlines the variables that can be implemented in Recharge. For general information, refer to the Notifications article. 

Before you start

• This documentation is meant to be used as a reference in order for you, your team, or a recommended third-party developer to accomplish. Customizations are not supported by Recharge's support team, as per the Recharge design and integration policy. 
• Recharge is a Python app and uses Jinja2, the Python Template Engine. You can use this list of built-in features.
• If you need more flexibility or do not have the technical resources to modify your notifications, we recommend using a compatible Communication and Email/SMS marketing third-party integration. Take a look at the apps and integrations.

Standard variables for notifications and scripts

Use these variables like the following example:

<td>
<span>{{discount_code}}</span>
</td>
<td>
<span>{{total_discounts | amount_with_currency(charge_currency, display_currency_code=False)}}
</span>
</td>

Variables for notification templates only

The following variables can only be used in the notification templates and cannot be used on the Thank You page.

Use these variables like the following example:

{% if shop_email %}
<p>Please email us <a href="mailto:{{ shop_email }}" about="_blank" rel="noopener noreferrer">here</a> if you have any questions about your subscription.</p>
{% endif %}

Variables requiring a loop

There are other variables you can use that are related to the items in the purchase. However, to use these types of variables, you must go through line_items within a loop.

Use these variables within a loop like the following example:

{% for item in line_items %}
{{ item.product_title }}
{% endfor %}

Displaying line item properties 

{% for item in line_items %}
	{% if item.properties %}
		{% for p in item.properties %}
			{{ p }}:{{ item.properties[p] }}
		{% endfor %}
	{% endif %}
{% endfor %}

Variables for multi-currency configuration

These variables can be used in the subscription activation, upcoming charge, advanced notice upcoming renewal charge (1+ year confirmation), and refund confirmation notifications to show or hide the currency country code.

To implement the multi-currency variables, replace insert price variable with "subtotal_price" or "total_price" or "total_discounts".

• To show the currency code: {{ insert price variable | amount_with_currency(charge_currency, display_currency_code=True) }}.
  • For example {{ total_price | amount_with_currency(charge_currency, display_currency_code=True) }}
• To hide the currency country code: {{insert price variable | amount_with_currency(charge_currency) }}.
  • For example {{ total_price |amount_with_currency(charge_currency) }}

Variables within additional scripts and trackers

You can use scripts containing variables on the Thank you page.

1. Click Storefront in your merchant portal and select Checkout.
2. Scroll down to the Thank you page section and add the code in the Add additional scripts and trackers text box.
3. (Optional) To test render the additional scripts and trackers section for a specific order, click Preview. 
4. Click Save once finished.
   
   

Use a "for loop" for line items

You can get variables on the item level as well using a for loop like:

{% for item in line_items %}{{item.sku}}, {% endfor %}

Render scripts on first-load

If you want the scripts to only render the first time the page is accessed, you can use the following lines of code.

{% if first_time_load %}
{% endif %}

Variables for SMS

SMS variables can be used with RechargeSMS or passwordless login to customize SMS notifications.

Note the following limitations when using SMS variables:

• SMS notifications have a 160-character limit.
• Each SMS variable, with the exception of access_code, counts as 30 characters towards the 160-character limit.
• Variables may be cut off when rendering a variable with a character value longer than the 30-character allocation. To ensure customer names are not cut off, we suggest using first_name and last_name as separate variables. 

Use these variables like the following example:

Hi {{customer_name}}, just wanted to let you know your order will be processing soon. 
To change your order, reply to this message with 'Modify Order' - {{shop_name}}

Common issues

Shopify

When copying over the Liquid code from the Shopify checkout, there are some key differences in the variables used in Recharge.

• When looping through items make sure it is {% for line_item in line_items %} not {% for line_item in order.line_items %}.
• Shopify only allows one discount per order so you can remove all the discount loops. Use {{ discount_code }} instead.
• Remove all filters like | money_without_currency.
• Note that the liquid directive "contains" doesn’t work in Recharge notifications.

{% if item.product_title contains "Auto Renew" %}

The alternative is using the "in" directive

{% if "Auto Renew" in item.product_title %}