(Plugin) Merge Tags

In this article, you will find information on how to add personalization tags to the Stripo plugin.

Marina Krivenets avatar
Written by Marina Krivenets
Updated over a week ago

If you want to personalize your emails and enable your customers to use your own merge tags, you can easily do it. 

What are merge tags?

Merge tags (variables for personalization) help dynamically insert text templates into a text, like very common scripts (e.g., "Dear {first_name}" ).

When you send the created email from your platform, the variable from the tag will be changed automatically in accordance with the information from your database for a particular recipient.

Merge tags can be inserted from a text formatting panel of the "Text" basic block by clicking on the "Merge tags" button.

After activating this option under the "Merge tags & Special Links" tab, the Stripo plugin will correctly handle all the transferred merge tags. Otherwise, this option won’t be displayed on the text formatting panel at all. 

Here is the example of creating mergeTags you can transmit with plugin initialization:

  "mergeTags": [
{
"category": "MailChimp",
"entries": [
{
"label": "First Name",
"value": "*|FNAME|*"
}
]
}
]


Here is the description of the parameters:

How to rename the "Merge tags" label and change the standard view?

You have the option to display your description for the "Merge tags" label (if you want to rename this feature) and change the standard view:

To the special icon:

To apply the changes, you must first initialize the plugin with the following settings:

"mergeTagsOptions":{
"useIcon":true,
"title":"test hint"
}

where:

"useIcon":true - this parameter replaces the standard name with an icon. If you want to get rid of it, use the "false" meaning;

"title" - hover description

How to activate the "Custom tags display" feature?

If you activate the "Custom tags display" feature, the name of the tag itself will be displayed instead of the existing merge-tag value in the email template:

To activate it, you should initialize the plugin with the following parameters:


"customAppearanceMergetags": true,

How to influence the appearance of displaying custom merge tags and links?

You independently choose how exactly your personalization tags should be displayed:

  • To add a description to the merge tag value, pass the "hint" parameter while initialization:

"mergeTags":[
{
"category":"MailChimp",
"entries":[
{
"label":"First name",
"value":"{{profile.first_name}}",
"hint":"Your own description"
}
]
}
],

Result:

  • To add a background color to the Custom displaying of the Merge tags, pass the "customAppearanceMergetagsBackgroundColor" parameter while initialization;

  • To add border color to the Custom displaying of the Merge tags, pass the "customAppearanceMergetagsBackgroundColor" parameter while initialization:

"customAppearanceMergetagsBorderColor":"blue",
"customAppearanceMergetagsBackgroundColor":"yellow"

Result:

  • To activate a custom Merge tag Appearance in the link field, pass the next parameter to the initialization:

"customAppearanceMergetagsInLinks":true,

Result:

How to pass hidden merge tags?

To do that, add a "hidden" parameter while initialization:

"mergeTags": [
{
"category": "MailChimp",
"entries": [
{
"label": "First Name",
"value": "*|FNAME|*",
"hidden":true
}
]
},
{
"category": "eSputnik",
"entries": [
{
"label": "First Name",
"value": "{{FirstName}}",
}
]
}
]

As a result, the Mailchimp merge tag is not visible:

If you add this parameter to all entries, you can completely hide the merge tags tool in the UI for a particular user.


Thank you for taking the time to read our articles. We hope you will find this information helpful.

If you have any additional questions, please email us at support@stripo.email.

We would be glad to talk with you.



Did this answer your question?