1. Ordergroove Knowledge Center
  2. Subscriptions and Enrollment
  3. How to Customize/Style Your Program Within Ordergroove

How To Style and Edit Your Emails

Updated

Ordergroove sends out transactional emails to your customers through an integration with SendGrid when select events and actions occur within your program. These emails can be managed within your Ordergroove Admin and include various dynamic personalization fields. You can find this page within Ordergroove by navigating to Subscriptions > Emails.

The default sender domain for emails is the following name and address:

  • Sent From: Merchant Name
  • Email: merchantname@reorder.com via sendgrid.net
  • "Merchant Name" in both the sent from and email field will be automatically changed to the actual merchant's name.

If you're looking for more information about the different types of emails we power, please check out the program transactional emails article.

How To Style/Edit Your Program Emails Within Ordergroove

To select the transactional email you would like to configure, navigate to the Choose a Template field and then select the email template you wish to edit from the dropdown menu.

Using the fields and WYSIWYG editor, edit the copy of your emails and style their appearance. Once you have finished editing your template, click the Save button in the upper right-hand corner.

Once you're happy with your changes, you can send yourself a test email by clicking the Send Test button. Test emails will be sent to the email address entered into the pop-up modal.

 

email_styling.jpg

Editing Emails Using The WYSIWYG Editor

Adding Images

Things you’ll need to have:

  • The images you want in .jpg, .png, or .svg format
  • Your image should be hosted — you’ll need the Public URL

Inside the editor's preview area, click into the area you’d like the image to be placed. When your cursor is blinking in the desired location, click the image button on the toolbar.

emailedit.jpg

This will bring up a modal that will allow you to enter the following:

  • Image URL
  • Desired dimensions (if applicable)
  • Alternative text (as a best practice, the alternative text would describe the image or purpose should the customer be visually impaired or have settings that would not enable images to display in the inbox)
  • Border width
  • Image alignment
  • Enable the image to be a link inside the link tab of the modal. This is perfect for inserting social media icons into the email.

    emailedit2.jpg

Changing The Font

Fonts and font stylings are limited to only a few options found on the toolbar.

emailedit3.jpg

If the styling options in the toolbar are not sufficient for what you’re trying to accomplish, you would need to make edits to the font family inside the code view of the editor.

Note: For the most control over the customization of your emails, we recommend editing the source code of each email in a text editor or using the Source editing feature of the WYSIWYG editor.

Editing Emails In The Source Code

Adding a Header Image

Things You'll Need:

  • The images you want in .jpg, .png, or .svg format
  • Your image should be hosted — you’ll need the Public URL
  • Add the public URL to the <img>  tag of the following HTML:
<tr>
  <td>
    <table role="presentation" cellpadding="0" cellspacing="0">
      <tbody>
        <tr>
          <td>
            <img width="550" id="banner" alt="Update this text, with spaces, to describe what this image is" src="ADD IMAGE URL HERE">
          </td>
        </tr>
      </tbody>
    </table>
  </td>
</tr>

emailedit4.jpg

Add the following CSS inside the <style> tag at the top of the code.

#banner{
    width: 100%;
}


Adding Images To The Email Body

Similar to adding a Header Image, you will need:

  • The images you want in .jpg, .png, or .svg format
  • Your image should be hosted — you’ll need the Public URL
  • Add the public URL to the <img>  tag of the following HTML, as well as updating the alternative text contained within alt=” ":
<tr>
  <td>
  <table>
    <tbody>
      <tr>
        <td style="width:150px;padding-right:10px;">
    <img width="150" alt="Update this text, with spaces, to describe what this image is" src="ADD IMAGE URL HERE" style="width:150px;" /></td>
        <td>
          <p>My text that will appear next to the image.....</p>
        </td>
      </tr>
    </tbody>
  </table>
  </td>
</tr>

This will display a row with two columns, with the image on the left. Should you want to display an image that is full width, see the section on adding a Header Image, and insert the table row in your desired location.

Changing The Font

For best results across email service providers, we recommend using Web Safe fonts. If you must work with fonts that are custom to your brand, there are ways to do that, although results across ESP’s will still vary.
When you’ve chosen the font you want, search for the following style declarations in the style section at the top of the email.
You’ll want to update only the property displayed within the curly brackets, like this:

table td {
    font-family: Georgia, serif;
}


h1,
h2,
h3,
h4 {
    font-family: Georgia, serif;
}

p,
ul,
ol {
    font-family: Georgia, serif;
}


Adding Social Icons

Things you’ll need to have:

  • The images you want in .jpg, .png, or .svg format
  • Your image should be hosted — you’ll need the Public URL
  • Add the public URL to the <img> tag of the following HTML:
<tr>
  <td>
    <table role="presentation" style="text-align: center;margin-top: 20px;">
      <tbody>
        <tr>
          <td class="social-icon">
            <a href="URL WHERE LINK SHOULD GO TO" target="blank">
             <img src="ADD PUBLIC URL HERE"  alt="Social Media Icon">             
            </a>

          </td>
          <td class="social-icon">
            <a href="URL  WHERE LINK SHOULD GO TO" target="blank">
             <img src="ADD PUBLIC URL HERE"  alt="Social Media Icon">
            </a>
          </td>
          <td class="social-icon">
            <a href="URL  WHERE LINK SHOULD GO TO" target="blank">
             <img src="ADD PUBLIC URL HERE"  alt="Social Media Icon">
            </a>
          </td>
        </tr>
      </tbody>
    </table>
  </td>
</tr>

Put the URL where the social media link should go inside the href of the <a> tags. Add the following CSS to the <style> section at the top of the source code.

.social-icon{
  width: 40px;
  display: inline-block;
  margin-right: 15px;
  padding: 10px;
  text-align: center;
}
.social-icon:last-child{
  margin-right: 0px;
}


Updating a URL

For various reasons, you may need to update a link, such as a link used for a social media icon.  This cannot be done one time for all emails, and instead, the link will need to be updated manually across all emails by finding the appropriate <a> tag and updating the href attribute, as noted below.

<a href="URL WHERE LINK SHOULD GO TO" target="blank">
 <img class="social-icon" width="40" src="https://i.imgur.com/DMN8jkh.png"  alt="Social Media Icon">             
</a>

 

Configurable Dynamic Tags Within Your Emails

Within each template, several dynamic tags can be entered to pull in customer-specific information. The available dynamic fields, per configurable email, are displayed below.  Note, we will only populate data into the dynamic field if it exists on Ordergroove’s database. (i.e., To display customers billing addresses, the fields will need to be passed to Ordergroove to display where the tags are positioned).

Note: Looped fields are a section that can contain multiple values for a single field key — i.e., order reminder emails can contain multiple order items.

All Emails

Personalization Field (Dynamic Tags)
{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004){{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{store_domain}} (example: https://shop.mystore.com)
{{customer_id}} (example: abc_123)

Single Subscription Started

Personalization Field (Dynamic Tags)

{{subscription.next_order_date}}
{{subscription.quantity}}
{{subscription.frequency}}
{{subscription.price}}
{{subscription.email_reminder}}
{{subscription.product.name}}
{{subscription.product.sku}}
{{subscription.product.url}}
{{subscription.product.img_url}}
{{subscription.public_id}}

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Prepaid Fields:

{{subscription.prepaid_subscription_context}}
{{subscription.prepaid_subscription_context.prepaid_orders_remaining}}
{{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}
{{subscription.prepaid_subscription_context.renewal_behavior}}

Bulk Subscription Started

Personalization Field (Dynamic Tags)

Subscription Loop

{{#subscriptions}}
{{this.product.url}}
{{this.product.img_url}}
{{this.product.name}}
{{this.quantity}}
{{this.frequency}}
{{this.unit_price}}
{{this.public_id}}
{{/subscriptions}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Prepaid Subscriptions (inside Subscription Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Out of Stock (OOS) Day 1, 15, 30

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove){{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{item.name}}
{{item.sku}}
{{item.url}}
{{item.img_url}}
{{item.qty}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Discontinued Product Swapped With Replacement

Personalization Field (Dynamic Tags)

{{first_name}}
{{last_name}}
{{subscription.product.name}}

Prepaid Fields:

{{subscription.prepaid_subscription_context}}
{{subscription.prepaid_subscription_context.prepaid_orders_remaining}}
{{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}
{{subscription.prepaid_subscription_context.renewal_behavior}}

Order Reminder

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Item Loop:
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Order Placed

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Item Loop:
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

CC Expiration Warning

Personalization Field (Dynamic Tags)

{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}


Item Loop:
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Order Not Placed -  CC Expired

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Item Loop
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Order Not Placed - CC Issue

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}


Item Loop
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Order Not Placed - Generic Issue

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}


Item Loop:
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

Subscription Canceled by Customer

Personalization Field (Dynamic Tags)

{{subscription.email_reminder}}
{{subscription.product.name}}
{{subscription.product.sku}}
{{subscription.product.url}}
{{subscription.product.img_url}}
{{subscription.public_id}}
{{first_name}}
{{last_name}}
{{email}}

Prepaid Fields:

{{subscription.prepaid_subscription_context}}
{{subscription.prepaid_subscription_context.prepaid_orders_remaining}}
{{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}
{{subscription.prepaid_subscription_context.renewal_behavior}}

Subscription Canceled - Item Discontinued

Personalization Field (Dynamic Tags)

{{subscription.email_reminder}}
{{subscription.product.name}}
{{subscription.product.sku}}
{{subscription.product.url}}
{{subscription.product.img_url}}
{{subscription.public_id}}
{{first_name}}
{{last_name}}
{{email}}

Prepaid Fields:

{{subscription.prepaid_subscription_context}}
{{subscription.prepaid_subscription_context.prepaid_orders_remaining}}
{{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}
{{subscription.prepaid_subscription_context.renewal_behavior}}

Subscription Reactivated

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove)
{{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{subscription.next_order_date}}
{{subscription.quantity}}
{{subscription.frequency}}
{{subscription.price}}
{{subscription.email_reminder}}
{{subscription.product.name}}
{{subscription.product.sku}}
{{subscription.product.url}}
{{subscription.product.img_url}}
{{subscription.public_id}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

 

Prepaid Fields:

{{subscription.prepaid_subscription_context}}
{{subscription.prepaid_subscription_context.prepaid_orders_remaining}}
{{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}
{{subscription.prepaid_subscription_context.renewal_behavior}}

Order Rejected - Retry Limit Reached

Personalization Field (Dynamic Tags)

{{shipping_address.first_name}} (example: John)
{{shipping_address.last_name}} (example: Doe){{shipping_address.company_name}} (example: Ordergroove)
{{shipping_address.address_1}} (example: 75 Broad Street)
{{shipping_address.address_2}} (example: 23rd Floor)
{{shipping_address.town}} (example: New York)
{{shipping_address.state}} (example: NY)
{{shipping_address.zip}} (example: 10004)
{{billing_address.first_name}} (example: John)
{{billing_address.last_name}} (example: Doe){{billing_address.company_name} (example: Ordergroove){{billing_address.address_1}} (example: 75 Broad Street)
{{billing_address.address_2}} (example: 23rd Floor)
{{billing_address.town}} (example: New York)
{{billing_address.state}} (example: NY)
{{billing_address.zip}} (example: 10004)
{{first_name}} (example: John)
{{last_name}} (example: Doe)
{{email}} (example: john.doe@gmail.com)
{{order.merchant_order_id}}
{{order.place_date_long}}
{{order.place_date_short}}
{{order.total_savings}}
{{order.subtotal}}
{{order.shipping_total}}
{{order.total}}

 

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Item Loop
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{item.subscription_public_id}}
{{item.public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

AI Churn Email

Personalization Field (Dynamic Tags)

{{first_name}}

{{payment.method}}

{{payment.type}}
{{payment.expire}}
{{payment.last4}}

Item Loop:
{{#items}}
{{this.name}}
{{this.sku}}
{{this.url}}
{{this.img_url}}
{{this.qty}}
{{this.subscription_price}}
{{this.subscription_public_id}}
{{this.total}}
{{/items}}

Prepaid Subscriptions (inside Item Loop):

{{this.prepaid_subscription_context}}
{{this.prepaid_subscription_context.prepaid_orders_remaining}}
{{this.prepaid_subscription_context.prepaid_orders_per_billing}}
{{this.prepaid_subscription_context.renewal_behavior}}

 

Prepaid Subscriptions

If you have prepaid subscriptions active in your store and use Sendgrid as your Email Service Provider (ESP), you can include prepaid subscription information in many of your emails. We've added a new field called prepaidsubscriptioncontext you can use to pull information.

Field Details
Prepaid_Subscription_Context

Determines if the item purchased is a prepaid subscription or not.

{{prepaid_subscription_context}}
Orders_Remaining

The number of orders a customer has left before their prepaid subscription renews or expires.

{{prepaid_subscription_context.prepaid_orders_remaining}}
Orders_Per_Billing

The total number of shipments the customer paid for upfront.

{{prepaid_subscription_context.prepaid_orders_per_billing}}
Renewal_Behavior

Determines if the prepaid subscription is set to auto-renew or expire after all shipments have been sent out. Displayed as either cancel or autorenew.

{{prepaid_subscription_context.renewal_behavior}}

The merge field is different depending on the email you're sending out:

  • Single Subscription Email: {{subscription.prepaid_subscription_context.action}}
  • Bulk Subscription Email: {{this.prepaid_subscription_context.action}}
  • Order Email: {{this.prepaid_subscription_context}}

Below are example code snippets you can use to add conditional logic to your emails. It'll display additional properties if a customer checks out with a prepaid subscription:

Single Subscription Started
{{#subscriptions}}

Product name: {{subscription.product.name}}

{{#if subscription.prepaid_subscription_context}}

Remaining: {{subscription.prepaid_subscription_context.prepaid_orders_remaining}}

Per billing: {{subscription.prepaid_subscription_context.prepaid_orders_per_billing}}

Renewal: {{subscription.prepaid_subscription_context.renewal_behavior}}

{{else}}

Not prepaid

{{/if}}

{{/subscriptions}}
Bulk Subscription Started
{{#subscriptions}}

Product name: {{this.product.name}}

{{#if this.prepaid_subscription_context}}

Remaining: {{this.prepaid_subscription_context.prepaid_orders_remaining}}

Per billing: {{this.prepaid_subscription_context.prepaid_orders_per_billing}}

Renewal: {{this.prepaid_subscription_context.renewal_behavior}}

{{else}}

Not prepaid

{{/if}}

{{/subscriptions}}
Order Email
{{#items}}

{{this.name}}

{{#if this.prepaid_subscription_context}}

Remaining: {{this.prepaid_subscription_context.prepaid_orders_remaining}}

Per billing: {{this.prepaid_subscription_context.prepaid_orders_per_billing}}

{{else}}

Not prepaid

{{/if}}

{{/items}}
Example Email: Bulk Subscription Created
{{#subscriptions}}

Product name: {{this.product.name}}

{{#if this.prepaid_subscription_context}}

Remaining: {{this.prepaid_subscription_context.prepaid_orders_remaining}}

Per billing: {{this.prepaid_subscription_context.prepaid_orders_per_billing}}

Renewal: {{this.prepaid_subscription_context.renewal_behavior}}

{{else}}

Next order date: {{this.next_order_date}}
{{this.product.img_url}}

{{/if}}

{{/subscriptions}}

FAQ's

Q: I need to update a link that appears in all my emails. Is there one place I can do this to affect all emails?

No, you will need to make all updates individually across all necessary emails.

Q: How do I host my image files so that I can use them for my emails?

Your hosting platform may already allow you to upload images. There are many sites out there like, Imgur, Google Photos, Flickr, and others that host images for free. All that is required is an account and the image file you want to upload.

Q: I want to add a button to my email. How do I do that?

This article on Bulletproof Buttons will help.

Q: The links in my email are blue. How do I change that?

You’ll need to specify what color you want the link to be and add styling to each link itself like this.
Q: I want to change my store domain. How do I do that?

The store domain is set up at provisioning, to change the shop domain, please contact support.

Further Reading