Skip to main content

How can we help?

Using the Notification node for Subscription Experience Strategies

Shopify Checkout integration Recharge Checkout on Shopify
Sections

Personalize your notifications and include dynamic information when building subscription experiences.

This guide lists the available variables per template, allowing you to create compelling and dynamic content.

Platform:
  • Shopify Checkout Integration

Before you start

  • The variables listed in this article only apply to the node notifications in the Surprise and Delight, Upcoming Order Cross-sell, and Failed Payment Recovery template builder.
  • Customers must opt-in to marketing to receive notifications. Failed Payment Recovery is the only Subscription Experience that does not require the customer to accept marketing. 
  • Notifications sent through the Failed Payment Recovery template are transactional, and cannot contain any marketing content or terminology. Avoid using marketing language in your Failed Payment Recovery notifications to remain compliant.

How it works

Each template includes a notification node, automating communication with your customers and making it easier to announce free gifts, incentives, or opportunities to recover failed payments.

You can include variables in your notifications to provide customers with dynamic and contextual information and personalize the experience to assert your brand and further customer loyalty.

Note: You cannot edit a Subscription Experience after activating it. You must create a new Subscription Experience to reflect any changes.

Using the notification node

Drag and drop the notification node onto the Surprise and Delight and Upcoming Order Cross-sell templates wherever you want to communicate with customers throughout the experience. 

Recharge prebuilt the Failed Payment Recovery template and included notifications at the right time in the customer journey to maximize customer recovery.

Click on the notification node and select Edit email body in any template to personalize the notification content. You can include any of the email variables to personalize your content. Available variables vary depending on the template.

The edit email body button allows you to edit the notification sent to customers

Preview your notification

Click on the preview notification button in the notification node to render the body of the email directly in the template.

The Preview notification button renders the template notification

Review the notification as if you were a customer, and make sure your variables read correctly. The experience may differ depending on the state of your template:

  • Draft templates: Some variables may not render, or Recharge may display placeholder values depending on the template type
  • Saved templates: The variables render correctly, and display the correct product name and price

Include variables in your notifications

Use the following variables in the body of your notifications to personalize the customer experience:

Variable

Description

Works with the following templates

{{customer.first_name}}

Customer’s first name
{{customer.last_name}}

Customer’s last name
{{customer.customer_portal_url}} Customer portal URL
{{store.name}} Your store name
{{offer.product_title}} The title of the product used in an offer
{{charge.scheduled_at}}

The scheduled date of the customer's next charge

This is the charge associated with the Subscription Experience
{{offer.discounted_price}} The discounted price of the product used in an offer
{{offer.offer_value}}

The value of the offer

This could be a percentage or fixed value, depending on the offer type
{{charge.currency}}

The currency of the customer's next charge

This is the charge associated with the Subscription Experience

 
{{ customer.total_credit_balance | amount_with_currency(credit_details.credit_currency) }}

The customer's total credit balance
{{ credit_details.credit_amount | amount_with_currency(credit_details.credit_currency) }}

The credit amount the customer earned in credits

{{customer.customer_portal_payment_methods_url}}

 

A direct link to the customer portal payment methods page

Note: If you use a custom customer portal as your URL, you can add the custom URL to your notifications. Recharge then switches the variable in your notifications from {{customer.customer_portal_payment_methods_url}} to {{custom_portal_url}}.

{{custom_portal_url}}

A direct link to your customer portal if you use a custom customer portal.
{{charge.shipping_address.address1}} {{charge.shipping_address.city}} {{charge.shipping_address.province}} {{charge.shipping_address.country_code}} {{charge.shipping_address.zip}}

The shipping address associated with the charge
{{charge.billing_address.address1}} {{charge.billing_address.city}} {{charge.billing_address.province}} {{charge.billing_address.country_code}} {{charge.billing_address.zip}}

The billing address associated with the charge
{{charge.error_type}}

The error on the charge
<h3>Items in Shipment</h3>
<table cellpadding="8px" style="border-collapse: collapse;">
{% for item in charge.line_items %}
<tr style="border-bottom: 1pt solid #CCC;">
<td>
<img src="{{item.images['small']}}" width="60" height="60" style="border-radius: 8px"/>
</td>
<td>
<div><b>{{item.title}} x {{item.quantity}}</b></div>
{% if item.variant and item.variant not in ("Default Title", "None", None) %} <div style="font-size:0.9rem;color:#444;">{{item.variant_title}}</div> {% endif %}
</td>
</tr>
{% endfor %}
</table>

A list of line items included in the failed order

{% if customer.get('total_credit_balance') is not none and customer.total_credit_balance > 0 %}

<p>You will lose {{ customer.total_credit_balance | amount_with_currency(credit_details.credit_currency) }} in store credits if your subscriptions are cancelled.</p>
{% endif %}

This code checks if a customer has store credits and, if so, displays a message warning customers that they will lose their credits if they cancel their subscription

 

 

 
Warning: Notifications sent through the Failed Payment Recovery flow are considered transactional, and cannot contain any marketing content or terminology. Make sure that your notifications avoid using marketing language to remain compliant.

Include images in your notifications

Easily upload and display images in your notifications to elevate communication and emphasize your brand. Use the notification node in the flow canvas to upload an image:

  1. Click on the notification node in the flow canvas and select Edit email body. 
  2. Click the image icon in the email body editor.
  3. Drag and drop your image, click select a file to upload your photo, or choose a previously uploaded image from the Image Library options.
  4. Click Upload when ready to upload the image to your notification.
  5. Click Close to exit the email body editor.

After selecting the Upload button, Recharge adds the image to the notification using a properly formatted <img> tag.

It's important to set the image size before uploading the photo to your notification, as you cannot edit the image size without using custom code. You can edit the <img> HTML tag to change the size of the image, however, this is outside of Recharge's scope of support.

Was this article helpful?
0 out of 0 found this helpful

Related articles

Didn’t find what you’re looking for?

Contact us