- DarkLight
Adding Dynamic Content with Personalization Tags
- DarkLight
Add dynamic and personalized content to your emails using personalization tags. With personalization tags, you can easily insert details such as the customer’s name, your store’s address, or a discount code directly into your email’s subject line, preview text, or body.
In this article, you’ll learn how to add personalization tags to emails.
How it works
Personalization tags are predefined bits of code that you add to your emails. When your campaign is sent out, the personalization tags get replaced with real data. The data for personalization tags will be pulled from various sources, depending on the tag. This may include customer details, Shopify store information, any integrations you have, Yotpo Email settings, or other Yotpo apps connected to your store.
To prevent emails from showing blank spaces when data is missing, you can use fallback text that appears instead. For example, if you’re personalizing an email subject with a recipient's first name, you might encounter missing data for some recipients. This could result in an incomplete subject line. By setting fallback text, like "friend", you ensure the subject remains complete and engaging.
Adding personalization tags to emails
You can add personalization tags to the email’s subject line, preview text, and body:
Open the email builder by creating a campaign or a flow from scratch, or by using an email template.
To add a tag to the Subject line and Preview text fields, click the Personalization tag icon. Search for or select a tag.
In the modal that opens:
Fill in the Fallback text field. To reuse this value in future campaigns or flows, keep the checkbox marked. If you want to apply it only to this message, unmark the box.
Important:
Adding fallback text is not possible for the following personalization tags:
Unsubscribe
View in browser
Discount tags such as Discount code
Store tags such as Store URL and Store zip code
Click Save.
To add a tag to the email body:
In the Email preview header, click Edit to open the email editor.
Select the Text block you want to edit
In the editor toolbar, click the Personalization tags icon, and search for or select a tag.
To add Fallback text to the tag, repeat the steps above.
Please note:
If a tag already has fallback text defined, the modal won’t appear when you add it to your email. To make changes, click the tag and update the fallback text.
Testing personalization tags
When you send yourself a test email, the personalization tags will be filled with sample data. Real data will only appear in emails that are sent to customers. If no sample data is available for a tag, such as those pulling information from custom profile properties, the tag's fallback text will be displayed if it has been set.
Tip:
You can also click the Preview button to see how your message will appear before sending it. Keep in mind that the data shown in the preview will be sample data only.
List of personalization tags
In the table below, you’ll find a list of the personalization tags you can use. The tags available in your account may differ depending on the apps and integrations you have.
Please note:
To see the Discount personalization tags, you first need to create a discount.
Tag name | Description |
---|---|
Customer | |
First name | Inserts your customer’s first name |
Last name | Inserts your customer's last name |
Customer email | Inserts your customer's email address |
Mobile number | Inserts your customer's mobile number |
Customer country | Inserts your customer's country |
Customer country code | Inserts your customer's country code |
Customer city | Inserts your customer's city |
Customer zip code | Inserts your customer's zip code |
Customer province | Inserts your customer's province |
Customer province code | Inserts your customer's province code |
Customer main address | Inserts your customer's main address |
Customer secondary address | Inserts your customer's secondary address |
Customer full address | Inserts your customer's full address, including city, state/region, and zip code |
Store | |
Store name | Inserts your organization's name |
Store URL | Inserts your organization's website |
Store city | Inserts your organization's city |
Store country | Inserts your organization's country |
Store zip code | Inserts your organization's zip code |
Store province | Inserts your organization's province |
Store main address | Inserts your organization's postal mailing address |
Store secondary address | Inserts your organization's secondary address |
Store full address | Inserts your organization's full address, including city, state/region, and zip code |
Discount | |
Discount code | Inserts the campaign discount code |
Discount value | Inserts the value of the discount, which can be a monetary amount, a percentage, or free shipping |
Discount URL | Inserts the discount URL |
Loyalty | |
Loyalty points balance | Insert the customer's current number of loyalty points |
Loyalty points earned | Inserts the number of loyalty points earned by the customer since joining the program |
Loyalty points needed | Inserts the number of points the customer must earn to reach the next VIP tier |
Loyalty VIP tier | Inserts the customer’s current VIP tier |
Loyalty VIP tier expiration | Inserts the date on which the customer’s VIP tier will expire |
Loyalty points expiration | Inserts the date on which the customer’s points will expire |
Loyalty last redeemed | Inserts the date on which the customer last redeemed points |
Loyalty credit balance | Inserts the customer’s current credit balance |
Purchases needed | Inserts the number of purchases the customer must make to reach the next VIP tier |
Spend needed | Inserts the amount of money the customer must spend to reach the next VIP tier |
Referrals needed | Inserts the number of referrals the customer must make to reach the next VIP tier |
Links | |
Unsubscribe | Inserts “Unsubscribe” text and link, as required by law |
View in browser | Inserts “View in browser” text and link, allowing recipients to view a browser-based copy of your email |
Custom Personalization tags you have added based on custom profile properties |