# Email subscription notifications (Customer Notifications)

Last updated: May 14, 2025

{% hint style="info" %}
**Tip:** If you prefer to send subscription order notifications via your existing ESP, read more about our [<mark style="color:blue;">integration with Klaviyo</mark>](/docs/support/integrations/klaviyo-x-smartrr-integration.md). You can also visit our [Tech Partners](https://smartrr.com/tech-partners) page to stay up-to-date integrations with email platforms.&#x20;
{% endhint %}

<figure><img src="/files/MxBe3iWEYmZQGLFknm3d" alt=""><figcaption></figcaption></figure>

## Overview

<figure><img src="/files/PDvn9e1lceZLOeSN3qyE" alt=""><figcaption></figcaption></figure>

You are able to send email notifications through Smartrr based on specific billing events. The available email notifications are:&#x20;

* **New subscription**&#x20;
  * **Subscription created – Existing customer:** Sent when a new subscription order is created for a customer who already has a customer account.
  * **Subscription created – New customer:** Sent when a new subscription order is created for a customer who does not have a customer account.
* **Subscription management**
  * **Upcoming subscription:** Email sent in advance of a recurring subscription order being placed.&#x20;
  * **Subscription auto-resume reminder:** Sent 7 days before a paused subscription is set to auto-resume.
  * **Payment expiration notice:** This is a CONDITIONAL email because it will only send in place of the "Upcoming subscription" email is the credit card used for an upcoming subscription is set to expire.&#x20;
  * **Item out of stock:** Sent when a customer’s subscription has an item has gone out of stock.
  * **Item moved due to out of stock:** Sent when an item in a customer's next subscription order has gone out of stock in Shopify and is being moved to the succeeding order.
  * **Subscription canceled:** Sent when a subscription order has been canceled.
  * **Subscription paused:** Sent when a subscription order has been paused.
  * **Subscription reactivated:** Sent when a subscription order has been reactivated.
* **Loyalty and referrals**
  * **Account creation reminder:** Sent to customers who checked out as a guest reminding them to create an account to continue earning points.
  * **Loyalty welcome:** Sent to customers who earn points for the very first time introducing them to the loyalty program.
  * **Redemption code:** Sends a copy of a redemption code via email to a customer who redeems a loyalty item and who does not have an active subscription.
  * **Rewards reminder:** Sent monthly to customers with a point balance to remind them to redeem for rewards.
  * **Bonus point earn:** Sent when a customer qualifies for a bonus earn event and receives additional points.
  * **Successful referral:** Sent to a customer when someone has successfully used their referral code.
  * **Reward item out of stock or deleted:** Sent when a redeemed reward item goes out of stock before a customer's next subscription order is scheduled to bill.
* **Gifted subscriptions**
  * **Gifted subscription:** Sent to gifter as confirmation that a subscription gift has been scheduled.
  * **Gifter subscription shipped:** Sent to gifter when a gifted subscription order has been shipped.
  * **Giftee subscription shipped:** Sent to the giftee when a gifted subscription order has been shipped along with gift message.
* **Passwordless Login** (The below emails will only send if passwordless login is enabled in Theming.)&#x20;
  * One-time code login: Provides a one-time code for a customer to log into their account.
  * Magic link login

{% hint style="info" %}
📧 Tip: For **Upcoming Subscription** emails, you are able to designate "Email send time" by the number of days before a subscription order is placed.
{% endhint %}

{% hint style="info" %}
Note: If you've enabled Smartrr's default templates, you won't be able to edit the content of individual emails. To edit the individual emails with HTML instead of with Smartrr's custom default templates, toggle **Enable default templates** to OFF.&#x20;
{% endhint %}

<figure><img src="/files/PEeKcyu2wtLUw0gD2WtS" alt=""><figcaption></figcaption></figure>

## How to Customize Default Templates

Navigate to **Customer Notifications** under CONFIGURATION in the left-hand menu.

<figure><img src="/files/hZDNhPe3b5PFKmVwdhrn" alt=""><figcaption></figcaption></figure>

Click on **Customize defaults** to globally add a logo and change color schemes for default email templates.

<figure><img src="/files/FMACvAKz1GusmiZwasge" alt=""><figcaption></figcaption></figure>

### Settings

* **Enable default template:** Enables Smartrr's default email templates to send for all emails that are turned ON. [<mark style="color:blue;">**Disable**</mark>](#custom-html-emails) if you prefer to use custom HTML for all email templates.
* **Enable email header / footer:** Injects a standard header and footer across all emails

  Reset default styles. Enable to add a JPEG or PNG logo across all emails. Footer information is pulled directly from your store's Shopify contact information.
* **Reset default styles:** When pressed, resets all header / footer, and color settings for all default email templates.&#x20;
* **Colors**: Changes background colors, primary text color, button color, and button text color for all email templates. Note: Secondary text color will only be visible in the footer when "Enable email header / footer" is toggled ON.&#x20;

### Custom HTML Emails

{% hint style="success" %}
Want to code your own email templates? Disable the toggle next to each email. To edit the template, click the hyperlink.

![](/files/TlIQoEUSs5u6XHRpMt7t)

Settings applied in Customize defaults will NOT appear if you are using custom-coded HTML.&#x20;
{% endhint %}

## Variables

Within the content of these emails, we provide a variety of event variables that can be used across all email templates in the Email Triggers tab. The syntax is available at the bottom of each page. You can click to copy the syntax and apply it to your emails.&#x20;

### Subscription

Syntax: `<%- subscription.VARIABLE %>`

<table><thead><tr><th width="150">Variable</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>Shopify subscription ID</td></tr><tr><td><code>nextBillingDate</code></td><td>Next billing date, formatted as <a href="https://www.w3.org/TR/NOTE-datetime">ISO 8601 </a>string</td></tr><tr><td><code>currency</code></td><td>Subscription currency</td></tr><tr><td><code>totalEstimatedNet</code></td><td>Total estimated price of subscription, formatted per currency</td></tr><tr><td><code>totalDiscount</code></td><td>Total amount of discounts applied to the subscription, formatted per currency</td></tr><tr><td><code>totalFromLineItems</code></td><td>Total from subscription line items, formatted per currency</td></tr><tr><td><code>totalLineItemsDiscount</code></td><td>Total discount applied to line items, formatted per currency</td></tr><tr><td><code>totalShipping</code></td><td>Total shipping price of subscription, formatted per currency</td></tr><tr><td><code>totalShippingDiscount</code></td><td>Total discount applied to shipping price, formatted per currency</td></tr></tbody></table>

### Lines

Syntax: `<%- subscription.lines[0].VARIABLE %>`

<table><thead><tr><th width="182.5151515151515">Variable</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>Shopify subscription line ID</td></tr><tr><td><code>basePrice</code></td><td>Line base price, formatted per line currency</td></tr><tr><td><code>isAddOn</code></td><td>Whether line item is an add-on (Yes / No)</td></tr><tr><td><code>priceAfterDiscounts</code></td><td>Subscription price after discounts are applied, formatted per line currency</td></tr><tr><td><code>quantity</code></td><td>Line quantity</td></tr><tr><td><code>product.id</code></td><td>Shopify product ID</td></tr><tr><td><code>product.name</code></td><td>Product name</td></tr><tr><td><code>variant.id</code></td><td>Shopify variant ID</td></tr><tr><td><code>variant.name</code></td><td>Variant name</td></tr></tbody></table>

### Customer

Syntax: `<%- customer.VARIABLE %>`

<table><thead><tr><th width="150">Variable</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>Shopify customer ID</td></tr><tr><td><code>firstName</code></td><td>Customer first name</td></tr><tr><td><code>lastName</code></td><td>Customer last name</td></tr><tr><td><code>email</code></td><td>Customer email</td></tr><tr><td><code>phone</code></td><td>Customer phone number</td></tr></tbody></table>

### Gifting (Note)

Syntax: `<%- note %>`

<table><thead><tr><th width="325">Variable</th><th width="200">Description</th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td><code>note</code></td><td>(No variable needed) Attached gift note</td><td></td><td></td></tr></tbody></table>

### Gifting (To)

Syntax: `<%- to.VARIABLE %>`

<table><thead><tr><th width="150">Variable</th><th>Description</th></tr></thead><tbody><tr><td><code>address1</code></td><td>Street address line 1</td></tr><tr><td><code>address2</code></td><td>Street address line 2</td></tr><tr><td><code>city</code></td><td>Address city</td></tr><tr><td><code>company</code></td><td>Company name</td></tr><tr><td><code>country</code></td><td>Country name</td></tr><tr><td><code>countryCode</code></td><td>Country code</td></tr><tr><td><code>firstName</code></td><td>Giftee's first name </td></tr><tr><td><code>lastName</code></td><td>Giftee's last name </td></tr><tr><td><code>phone</code></td><td>Phone </td></tr><tr><td><code>province</code></td><td>State</td></tr><tr><td><code>provineCode</code></td><td>State code</td></tr><tr><td><code>zip</code></td><td>Zip code</td></tr></tbody></table>

### Gifting (From)

Syntax: `<%- from.VARIABLE %>`

<table><thead><tr><th>Variable</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td><code>firstName</code></td><td>Sender's first name</td><td></td></tr><tr><td><code>lastName</code></td><td>Sender's last name</td><td></td></tr></tbody></table>

{% hint style="info" %}
The ‘Gift Created Email’ template also has access to a **`shippedOn`** variable.
{% endhint %}

### Item out of Stock

Syntax: `<%- outOfStockItem.VARIABLE %>`

| Variable      | Description                  |
| ------------- | ---------------------------- |
| `id`          | Shopify product ID           |
| `name`        | Shopify product name         |
| `variantName` | Shopify product variant name |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.smartrr.com/docs/support/subscription-setup/email-subscription-notifications-customer-notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.