Placeholder variables in email notifications

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. ✉️

What is a variable?

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.

Points Earned

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

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

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

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
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)
Referral Shared Through Smile
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

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

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

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.