Skip to main content

Referral email dynamic variables

Use dynamic variables to reference different rewards and aspects of your referral program

Stuart Chaney avatar
Written by Stuart Chaney
Updated over a week ago

Introduction

Dynamic variables allow you to personalize your referral program emails with customer-specific information. By adding these variables to your email content, you can create more engaging and relevant communications that drive higher conversion rates. This comprehensive guide covers all available dynamic variables for the six types of referral emails in your loyalty program.

✨ Emails featured in this article are part of the referral campaigns available on Scale and Plus plans


How to Use Dynamic Variables

To use dynamic variables in your email content:

  1. Go to Programs > Emails in your Rivo dashboard

  2. Click Edit on the email notification you want to customize

  3. Add the variable in the format ####{{variable_name}} in the text fields

πŸ’‘ Example: If you type "Thank you for referring your friend ####{{friend_email}}" in the subtitle field, the customer would see "Thank you for referring your friend [email protected]" in the actual email.


Advocate Signup Email Variables

When sent: Automatically triggered when a customer joins your referral program as an advocate.

Purpose: Welcome new advocates and encourage them to start sharing their referral link.

Dynamic variable

Description

####{{shop_name}}

Your store name

πŸ’‘ Example usage: "Welcome to the ####{{shop_name}} referral program! Start sharing your link to earn rewards."


Advocate Stats Email Variables

When sent: Periodic emails (typically monthly) showing referral performance to active advocates.

Purpose: Keep advocates engaged by showing their referral success and encouraging continued sharing.

Dynamic variable

Description

####{{shop_name}}

Your store name

πŸ’‘ Example usage: "Your ####{{shop_name}} Referral Stats - Thanks for sharing with your friends. Here are your referral stats:"


Referred Signup Email Variables

When sent: Sent to friends when they successfully sign up through a referral link and earn their reward.

Purpose: Confirm the friend's reward and encourage them to use it.

Dynamic variable

Description

####{{reward_name}}

The name of the reward the friend has earned

####{{reward_tos}}

Terms of service and conditions for using the reward

πŸ’‘ Example usage: "Congratulations, you've earned the reward ####{{reward_name}}! ####{{reward_tos}}"


Referrer Delayed Reward Email Variables

When sent: Sent to advocates when their rewards are ready after a verification or waiting period.

Purpose: Notify advocates that their friend's order has been verified and their reward is now available.

Dynamic variable

Description

####{{friend_email}}

The email address of the friend whose order was verified

####{{reward_tos}}

Terms of service and conditions for using the reward

πŸ’‘ Example usage: "Your friend's order was verified! ####{{friend_email}} had their order verified. Here's your reward. ####{{reward_tos}}"


Referrer Reward Email Variables

When sent: Sent to advocates immediately when their referrals are completed and verified.

Purpose: Notify advocates that their friend has completed the referral and they've earned their reward.

Dynamic variable

Description

####{{friend_email}}

The email address of the friend who completed the referral

####{{reward_tos}}

Terms of service and conditions for using the reward

πŸ’‘ Example usage: "Your friend used your referral link! ####{{friend_email}} completed their referral. ####{{reward_tos}}"


Referral Ineligible Email Variables

When sent: Sent to advocates when a referral doesn't meet the program requirements (e.g., minimum order value not met).

Purpose: Inform advocates why a referral wasn't successful and encourage them to continue referring.

Dynamic variable

Description

####{{friend_email}}

The email address of the friend whose order was not eligible

πŸ’‘ Example usage: "Your friend ####{{friend_email}} did not meet the requirements for completing the referral."


Universal Variables

These variables can be used across multiple email types where applicable:

Dynamic variable

Description

####{{shop_name}}

Your store name (available in most email types)

####{{friend_email}}

The referred friend's email address

####{{reward_name}}

The name of the reward being offered or earned

####{{reward_tos}}

Terms of service text for rewards

####{{advocate_name}}

The name of the person making the referral

####{{expiry_date}}

When a reward expires (if applicable)

####{{points_amount}}

Number of points earned (for points-based rewards)


Best Practices for Using Dynamic Variables

Testing and Quality Assurance

  • Preview before sending: Always use the email preview feature to see how variables will appear

  • Test with real data: Send test emails to yourself to verify variable population

  • Check all scenarios: Test emails for different reward types and campaign configurations

Email Personalization Tips

  • Subject lines: Use ####{{shop_name}} or ####{{reward_name}} to make subject lines more compelling

  • Personal touch: ####{{friend_email}} helps advocates see exactly who completed their referral

  • Clear expectations: Always include ####{{reward_tos}} when mentioning rewards to set proper expectations

  • Urgency: Use ####{{expiry_date}} when applicable to create urgency around reward usage

Design Considerations

  • Variable length: Account for varying lengths of reward names and email addresses in your design

  • Fallback content: Design emails to still make sense if a variable is empty

  • Consistent formatting: Variables inherit surrounding text formatting, so style accordingly


Troubleshooting Common Issues

Variables Not Displaying

  • Verify you're using the exact variable name with correct spelling

  • Ensure you're using the proper format with triple hash and double curly braces: ####{{variable_name}}

  • Check that the variable is available for the specific email type you're editing

Empty or Missing Data

  • Some variables may be empty if the required data isn't available for that customer

  • Consider using conditional text or fallback content for optional variables

  • Test your emails with different customer scenarios to identify potential gaps

Formatting Problems

  • Variables inherit the formatting (bold, italic, color) of the surrounding text

  • Long variable content (like email addresses) may affect email layout on mobile devices

  • Test your emails across different devices and email clients

πŸ’‘ Pro Tip: You can use multiple variables in the same sentence for more personalized messaging. For example: "Hi there! ####{{friend_email}} just used your referral link to shop at ####{{shop_name}} and earned ####{{reward_name}}!"


Need Help?

If you're having trouble with referral email variables, need assistance setting up your referral program, or want to optimize your email performance, please contact our support team. We're here to help you create engaging, personalized referral emails that drive results for your business.


Common Questions

How do I set up Tiered Referral Campaigns?

You can set up tiered referral campaigns by contacting your customer success manager at [email protected].

Why aren't my variables showing up in the emails?

Make sure you're using the correct format: ####{{variable_name}}. If you're still having issues, check that the variable is applicable to that specific email type.

Can I use variables in all parts of the email?

Yes, you can use dynamic variables in the subject line, title, subtitle, and body text of your emails.

Where can I find the preview of my email with the variables?

You can send a test email to yourself by going to Programs > Emails, clicking Edit on the email you want to preview, and then clicking "Send test email" at the bottom of the editor.

Did this answer your question?