How can I personalize emails sent to participants?

GrowSurf lets you use dynamic text to help you create emails that are personalized to each email recipient, in order to improve open and click rates.

Variables (Basic)

Use variables to generate dynamic text.

Variable Description Restrictions Example
{{email}} Participant's email
[email protected]
{{firstName}} Participant's first name
Emily
{{lastName}} Participant's last name
Smith
{{rank}} Participant's rank
3
{{participantId}} Participant's ID x87aD
{{impressions}} Participant's impressions count
94
{{uniqueImpressions}} Participant's unique impressions count
21
{{referrals}} Participant's referral count in total
9
{{monthlyReferrals}} Participant's referral count this month
2
{{shareUrl}} Participant's unique referral link — generated as HTML*

<a href="{{shareUrl}}" clicktracking="off">{{shareUrl}}</a>

https://company.com?grsf=x87aD
{{shareUrlRaw}} Participant's unique referral link — generated as raw text

{{shareUrlRaw}}
https://company.com?grsf=x87aD
{{rewardWon}} The description of the most-recent reward that the participant has won (the appropriate reward description will be displayed based on whether the winner is a referrer or referred friend)
Can only be used in email templates New Participant Reward and Campaign Ended (to winners)

Refer 2 people and receive a Tesla duffel bag not available for general purchase.

{{rewardWonCoupon}} The coupon code of the most-recent reward that the participant has won (the appropriate reward coupon will be displayed based on whether the winner is a referrer or referred friend).

NOTE: If you have a third-party integration enabled like Stripe Coupons then {{rewardWon}} will be overwritten with the value of the unique coupon code.
Can only be used in email templates New Participant Reward and Campaign Ended (to winners) X7LKD
{{isReferrer}} If the participant is the referrer (only applies to double-sided rewards) Can only be used in email template New Participant Reward true
{{campaignRewards}} A list of all rewards in the campaign
  • Refer 2 people and receive a Tesla duffel bag not available for general purchase.
  • Refer 3 people and receive a Tesla owners jacket not available for general purchase.
{{referrerEmail}} The referrer's email Can only be used in email template  Invite [email protected]
{{referrerFirstName}} The referrer's first name Can only be used in email template  Invite Emily
{{referrerLastName}} The referrer's last name Can only be used in email template  Invite Smith
{{referrerShareUrl}} The referrer's unique referral URL Can only be used in email template  Invite https://company.com?grsf=x87aD
{{referrerMessage}} The referrer's custom message they wrote when sending out email invites. Can only be used in email template  Invite I've been using this service for a few years and I'd highly recommend it. If you sign up, we both get 3 months free: https://company.com?grsf=x87aD
{{oneTimeLoginLink}} A one-time login link that the participant can authenticate with Can only be used in email template  One-Time Login Link https://piedpiper.com?grsf_auth_token=240a8047b973c20
{{oneTimeLoginLinkExpiration}} The expiration period (in hours) of the one-time login link that the participant can authenticate with. This value will always be 12 hours.
Can only be used in email template  One-Time Login Link 12
{{oneTimeLoginLinkRequestUrl}}
The URL that the participant requested their one-time login link from Can only be used in email template  One-Time Login Link https://piedpiper.com
{{landingPageUrl}} The referral portal the participant can visit to grab their unique link and track their rewards progress https://refer.piedpiper.com
{{landingPageUrlWithAuth}} The referral portal the participant can visit to grab their unique link and track their rewards progress (participant will automatically be added or logged in) https://[email protected]

*{{shareUrl}} is generated as an HTML anchor link with a clicktracking="off" attribute. This is necessary for your email recipients to properly copy/paste their unique share URLs from their email client; otherwise, copy/pasting will produce an obfuscated and longer URL generated by GrowSurf's email service provider (e.g, http://click.growsurf.com/ls/click?upn=QPpqCxKpqDVKM14 ). Please note, that referral tracking will still work, but the copied link isn't preferable for your participants to share.


For example:

Hi {{firstName}},

if the participant’s first name is  Emily, the results will look like this:

Hi Emily,

Fallbacks (Basic)

GrowSurf parses dynamic text as JavaScript. Use fallbacks in case a variable doesn’t have a value.

For example:

Hi {{firstName || 'Friend'}},

if the participant’s first name is  Emily, the results will look like this:

Hi Emily,

if the participant does not have a first name, the results will look like this:

Hi Friend,

Conditionals (Advanced)

Since GrowSurf parses dynamic text as JavaScript, that means you can use conditional expressions to display different text based on different scenarios.

For example:

Did you know that {{ referrals >= 1 ? "you’re doing an awesome job!" : "you can refer your friends to win big" }}!

If the participant has 1 or more referrals, the results will look like this:

Did you know that you're doing an awesome job!

If the participant has less than 1 referral, the results will look like this:

Did you know that you can refer your friends to win big prizes?

New Participant Reward Emails

Display different text based on the reward won:

You can use the    {{rewardWon}}  conditional in the following manner:

  1. Go to Campaign Editor > 1. Rewards and copy the description of each reward (to be used in next step)
  2. Go to Campaign Editor > 3. Emails, and edit the New Participant Reward email. Here is an example:

{{rewardWon === 'Refer a friend and win a shirt!' ? 'You just won a shirt!' : ''}}

{{rewardWon === 'Refer a friend and win a sticker!' ? 'You just won a sticker!' : ''}}

This will either show up like this:

You just won a shirt!

Or like this:

You just won a sticker!

Display different text based on if the participant is the referrer or referred friend

You can use the {{isReferrer}} conditional if your campaign has a double-sided reward and you want to discern between the referrer and the referred friend's unlocked reward.

For example:

{{isReferrer ? "You won a free trip to Mexico!" : "You've received 1 month free of our Startup plan!" }}

If the participant is the referrer, the results will look like this:

You won a free trip to Mexico!

If the participant is the referred friend, the results will look like this:

You've received 1 month free of our Startup plan!

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.