> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cardclan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Merge Tags

> Personalize your cards with dynamic content using CardClan's merge tag system

## 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

```mermaid theme={null}
graph LR
    A[Card Template] --> B[API Request with Merge Tags]
    B --> C[CardClan Processing]
    C --> D[Personalized Card]
```

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}}` → "[john@example.com](mailto:john@example.com)"

## Standard Merge Tags

CardClan supports these commonly used merge tags:

<AccordionGroup>
  <Accordion title="Personal Information">
    * `{{ name }}` - Full name - `{{ email }}` - Email address
  </Accordion>

  <Accordion title="Custom Fields">
    * Any custom field name you define - Examples: `{{ productName }}`, `{{ accountManager }}`, `{{ eventDate }}`
  </Accordion>
</AccordionGroup>

## Using Merge Tags in API Requests

When sending a card, provide merge tag values in the `mergeTags` array:

<CodeGroup>
  ```json Basic Example theme={null}
  {
    "card": "60f7b2b5b8f4a20015a4f5a5",
    "integrationId": "60f7b2b5b8f4a20015a4f5a7",
    "mergeTags": [
      {
        "name": "John Doe",
        "email": "john@example.com",
        "company": "Acme Corp"
      }
    ]
  }
  ```

  ```json Complete Example theme={null}
  {
    "card": "60f7b2b5b8f4a20015a4f5a5",
    "integrationId": "60f7b2b5b8f4a20015a4f5a7",
    "mergeTags": [
      {
        "name": "Sarah Johnson",
        "firstName": "Sarah",
        "lastName": "Johnson",
        "email": "sarah@techstartup.com",
        "company": "TechStartup Inc",
        "position": "Marketing Director",
        "phone": "+1-555-0123",
        "city": "San Francisco",
        "productName": "Pro Plan",
        "accountManager": "Mike Smith",
        "trialEndDate": "2024-02-15"
      }
    ]
  }
  ```
</CodeGroup>

<Info>The `mergeTags` parameter expects an array, but typically contains a single object with the recipient's data.</Info>

## Next Steps

Now that you have learned about merge tags:

1. [Explore examples](/examples/send-card)
2. [Explore the API reference](/api-reference/integration/overview) for detailed endpoint documentation