All guides
Campaigns & emails
Personalize emails with merge tags
1 min read · Updated
A merge tag is a placeholder such as {{first_name}} that is replaced with each recipient’s own value right before sending. Type them into any Text, Heading or Button block, or into Custom HTML.
When a value is missing
If a contact has no value for a tag, the tag is replaced with nothing. It is not left as raw {{...}} text, and no placeholder word is filled in. Write copy that reads naturally either way: Hi {{first_name}}, becomes “Hi,” for someone without a first name.
Custom properties
Any custom property on a contact, whether it came from an import, a form or the API, works as a merge tag of the same name: a property called plan becomes {{plan}}. A misspelled tag also renders as nothing, so send yourself a test before the real send.
Personalized links
The Footer block writes its links as [Unsubscribe]({{unsubscribe_url}}), that is [link text](url). Use the same pattern anywhere a link should be different for each recipient.
