Skip to main content

​
What are Merge Tags?

Merge tags are placeholders in your cards that get replaced with dynamic, personalized content when the card is sent. They allow you to create one card template that can be customized for each recipient with their specific information.

​
How Merge Tags Work

When you send a card via API:
  1. Template: Your card contains merge tag placeholders like {{name}}
  2. Data: You provide the actual values in your API request
  3. Processing: CardClan replaces placeholders with real data
  4. Result: Recipient gets a personalized card

​
Merge Tag Syntax

Merge tags use double curly braces syntax: 
{{tagName}}
Examples:
  • {{name}} → “John Doe”
  • {{company}} → “Acme Corporation”
  • {{email}} → “[email protected]”

​
Standard Merge Tags

CardClan supports these commonly used merge tags:
  • {{ name }} - Full name - {{ email }} - Email address
  • Any custom field name you define - Examples: {{ productName }}, {{ accountManager }}, {{ eventDate }}

​
Using Merge Tags in API Requests

When sending a card, provide merge tag values in the mergeTags array: 
{
  "card": "60f7b2b5b8f4a20015a4f5a5",
  "integrationId": "60f7b2b5b8f4a20015a4f5a7",
  "mergeTags": [
    {
      "name": "John Doe",
      "email": "[email protected]",
      "company": "Acme Corp"
    }
  ]
}
The mergeTags parameter expects an array, but typically contains a single object with the recipient’s data.

​
Next Steps

Now that you have learned about merge tags:
  1. Explore examples
  2. Explore the API reference for detailed endpoint documentation