Placeholder variables in email notifications

Introduction

In Smile, we use placeholder text to make it easier to understand our email notification previews. In this tutorial we will go over these variables and what you will see in the Notifications section. ✉️

Here's what we're covering:

What is a variable?

A variable is a value that can change depending on conditions or on information passed to the program.

Our previous variables were displayed in code, which could sometimes be difficult for the user to interpret or understand.

We've updated our placeholder text to reflect more simplified language for better understanding of what will appear in a users emails depending on what variables were used.

Here is a list of variables, and the placeholder texts that represent them in email notifications.

📋  Note:
In your notification templates - please add {{ }} around the Variable for them to work. If you see the Placeholder text show up in the preview - you have added the variable correctly.

For example - {{customer.email}}

Points Earned

Smile will send this notification any time a customer performs an action for which points can be rewarded. Joining the program, purchases from your store, or social sharing are the most common activities that will generate an email of this type. See an example here.

Variable Example Placeholder text
customer.email scooby@smile.io (customer email)
customer.first_name Scooby (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
reward_fulfillment.action_text (reward CTA)
reward_fulfillment.action_url (reward URL)
reward_fulfillment.code 7f3eb79d8d74c334 (reward code )
reward_fulfillment.name 500 Points (reward name)
reward_fulfillment.source_description Placed an order (action completed)
reward_fulfillment.usage_instructions Use this discount code on your next order! (reward instructions)
reward_fulfillment.terms_and_conditions Some conditions apply (reward terms and conditions)

Reward Redeemed

Customers who spend their points on a reward, whether a $ or % of coupon, free product (on a Smile Paid Plan), or any other reward you've configured will receive an email of this type. See an example here.

Variable Example Placeholder text
customer.email batman@smile.io (customer email)
customer.first_name Batman (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
reward_fulfillment.action_text View Product (reward CTA)
reward_fulfillment.action_url https://recharge.com/asdfg (reward URL)
reward_fulfillment.code XXXX-YYYY-ZZZZ (reward code )
reward_fulfillment.name $5 off discount (reward name)
reward_fulfillment.source_description Spent 500 points (action completed)
reward_fulfillment.usage_instructions Use on your next subscription order and save! (reward instructions)
reward_fulfillment.terms_and_conditions Reward can only be used on subscription products. (reward terms and conditions)

Birthday Reward

Celebrate your customers special day! This email will be sent out on their birthday and can be redeemed like any other reward any time after it is issued. See an example here.

Variable Example Placeholder text
customer.email Jaco@smile.io (customer email)
customer.first_name Jaco (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
reward_fulfillment.action_text (reward CTA)
reward_fulfillment.action_url (reward URL)
reward_fulfillment.code 7f3eb79d8d74c334 (reward code )
reward_fulfillment.name 500 Points (reward name)
reward_fulfillment.source_description Celebrated a birthday (action completed)
reward_fulfillment.usage_instructions Use this discount code on your next order! (reward instructions)
reward_fulfillment.terms_and_conditions Some conditions apply (reward terms and conditions)

Points Expiry - Warning

If you have points expiry turned on (we recommend that you do -- learn how here) this email will go out well before the points expire for your customer (30 days is the default). See an example here.

Variable Example Placeholder text
customer.email sully@smile.io (customer email)
customer.first_name Sully (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
points_expiry_date_formatted June 15th, 2019 (points expiry date)

Points Expiry - Last Chance

If you have points expiry turned on (we recommend that you do -- learn how here) this email will go out just before the points expire for your customer (3 days is the default). See an example here.

Variable Example Placeholder text
customer.email noah@smile.io (customer email)
customer.first_name Noah (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
points_expiry_date_formatted June 15th, 2019 (points expiry date)

Reward expiry

If you have reward expiry turned on (recommended — find out how here) your customer will get this email to notify them if one of their rewards is about to expire. See an example here.

Variable Example Placeholder text
customer.email onyx@smile.io (customer email)
customer.first_name Onyx (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
reward_fulfillment.action_text View Product (reward CTA)
reward_fulfillment.action_url https://recharge.com/asdfg (reward URL)
reward_fulfillment.code XXXX-YYYY-ZZZZ (reward code )
reward_fulfillment.name $5 off discount (reward name)
reward_fulfillment.source_description Spent 500 points (action completed)
reward_fulfillment.usage_instructions Use on your next subscription order and save! (reward instructions)
reward_fulfillment.terms_and_conditions Reward can only be used on subscription products. (reward terms and conditions)
reward_fulfillment.expires_at_formatted June 15, 2019 (reward expiry date)

Referral Shared through Smile

Referrals are a great way to build your customer base. This email is sent to all your customers friends when they send out their referral link. See an example here.

Variable Example Placeholder text 
advocate_customer.email finnegan@smile.io (advocate email)
advocate_customer.first_name Finnegan (advocate first name)
advocate_customer.next_vip_tier.id 2 (advocate next vip tier level)
advocate_customer.next_vip_tier.name Gold (advocate next vip tier name)
advocate_customer.points_balance 1000 (advocate points balance)
advocate_customer.points_balance_formatted 1000 Points (advocate points balance with currency name)
advocate_customer.referral_url http://i.refs.cc/12345 (advocate referral link)
advocate_customer.vip_milestone_description Earn 500 more Points to reach Gold! (advocate amount until next tier)
advocate_customer.vip_tier.id 1 (advocate VIP tier level)
advocate_customer.vip_tier.name Silver (advocate VIP tier name)
friend_reward.name $5 off discount (friend reward)
message Check out this awesome store! (message)

Friend Received Referral

This email is sent to a friend when they’ve claimed a referral reward sent to them by your customer. See an example here.

Variable Example Placeholder text
advocate_customer.email mojo@smile.io (advocate email)
advocate_customer.first_name Mojo
(advocate first name)
advocate_customer.next_vip_tier.id 2 (advocate next vip tier level)
advocate_customer.next_vip_tier.name Gold (advocate next vip tier name)
advocate_customer.points_balance 1000 (advocate points balance)
advocate_customer.points_balance_formatted 1000 Points (advocate points balance with currency name)
advocate_customer.referral_url http://i.refs.cc/12345 (advocate referral link)
advocate_customer.vip_milestone_description Earn 500 more Points to reach Gold! (advocate amount until next tier)
advocate_customer.vip_tier.id 1 (advocate VIP tier level)
advocate_customer.vip_tier.name Silver (advocate VIP tier name)
reward_fulfillment.action_text View Product (reward CTA)
reward_fulfillment.action_url https://recharge.com/asdfg (reward URL)
reward_fulfillment.code XXXX-YYYY-ZZZZ (reward code )
reward_fulfillment.name $5 off discount (reward name)
reward_fulfillment.source_description Spent 500 points (action completed)
reward_fulfillment.usage_instructions Use on your next subscription order and save! (reward instructions)
reward_fulfillment.terms_and_conditions Reward can only be used on subscription products. (reward terms and conditions)

Referral Completed

When your customers friend has made a purchase using their referral reward code your customer who referred that friend will get this email notification. See an example here.

Variable Example Placeholder text
customer.email linux@smile.io (customer email)
customer.first_name Linux (customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
friend_customer.email asher@smile.io (friend email)
friend_customer.first_name Asher (friend first name)
friend_customer.next_vip_tier.id 1 (friend next VIP tier level)
friend_customer.next_vip_tier.name Silver (friend next VIP tier name)
friend_customer.points_balance 200 (friend points balance)
friend_customer.points_balance_formatted 200 Points (friend points balance with currency name)
friend_customer.referral_url http://i.refs.cc/54321 (friend referral link)
friend_customer.vip_milestone_description Earn 200 more Points to reach Silver! (friend amount until next tier)
friend_customer.vip_tier.id 3 (friend VIP tier level)
friend_customer.vip_tier.name Bronze (friend VIP tier name)
reward_fulfillment.action_text View Product (reward CTA)
reward_fulfillment.action_url https://recharge.com/asdfg (reward URL)
reward_fulfillment.code XXXX-YYYY-ZZZZ (reward code )
reward_fulfillment.name $5 off discount (reward name)
reward_fulfillment.source_description Spent 500 points (action completed)
reward_fulfillment.usage_instructions Use on your next subscription order and save! (reward instructions)
reward_fulfillment.terms_and_conditions Reward can only be used on subscription products. (reward terms and conditions)

VIP Tier Achieved

If you've implemented a VIP program (available on a Smile Paid Plan) this email is sent to your customer when they’ve achieved a higher VIP tier. See an example here.

Variable Example Placeholder text
customer.email buddy@smile.io (customer email)
customer.first_name Buddy
(customer first name)
customer.next_vip_tier.id 2 (next VIP tier level)
customer.next_vip_tier.name Gold (next VIP tier name)
customer.points_balance 1000 (points balance)
customer.points_balance_formatted 1000 Points (points balance with currency name)
customer.referral_url http://i.refs.cc/12345 (referral link)
customer.vip_milestone_description Earn 500 more Points to reach Gold! (amount until next tier)
customer.vip_tier.id 1 (VIP tier level)
customer.vip_tier.name Silver (VIP tier name)
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.