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

# Personalized Embed Link for Email Platforms

> Use personalized card embed links in your email campaigns to deliver unique, trackable cards to each recipient.

When you send a card through CardClan, each recipient gets a **unique personalized link** that tracks engagement and personalizes the viewing experience. This guide explains how personalized embed links work and how to use them in external email platforms like Mailchimp, HubSpot, or any SMTP-based sender.

## How Personalized Links Work

Every card sent through CardClan generates a unique URL per recipient:

```
https://yourdomain.com/viewcard/{cardId}?recipientId={recipientId}
```

This link:

* **Tracks opens** — each view is attributed to the specific recipient
* **Personalizes the experience** — the card can display the recipient's name and custom merge tag data
* **Supports custom domains** — if you have a white-label domain configured, links use your domain instead of `app.cardclan.io`
* **Includes unsubscribe** — every email includes a recipient-specific unsubscribe link

## Email Preview Customization

You can customize how the card appears in the delivery email from your workspace settings:

| Setting               | Description                                                                                                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Header Text**       | Custom greeting shown above the card preview (default: "Hey {name}, {sender} made this digital card for you") |
| **Footer Text**       | Custom message below the card (default: "Your inbox just got a special delivery. View your card online.")     |
| **Button Color**      | CTA button color (default: `#FF3C69`)                                                                         |
| **Button Text**       | CTA button label (default: "View card")                                                                       |
| **Button Style**      | Rounded or square corners                                                                                     |
| **Company Logo**      | Your logo displayed in the email                                                                              |
| **Background**        | Solid color or gradient behind the card preview                                                               |
| **CardClan Branding** | Toggle CardClan branding on/off (available with white-label)                                                  |

## Using the Copycard URL in Email Platforms

For bulk campaigns through external email platforms, you can use the **Copycard URL** approach. This generates a single URL that creates a personalized experience for each opener.

### Step 1: Get Your Card's Copycard URL

After designing your card, grab the copycard URL from the card settings. The format is:

```
https://app.cardclan.io/viewcard/{cardId}
```

### Step 2: Add Merge Tags for Personalization

CardClan supports merge tags that dynamically insert recipient data. When using an external email platform, append recipient information as query parameters:

```
https://app.cardclan.io/viewcard/{cardId}?name={{firstName}}&email={{email}}
```

Replace `{{firstName}}` and `{{email}}` with your email platform's merge tag syntax:

| Platform           | First Name Tag          | Email Tag           |
| ------------------ | ----------------------- | ------------------- |
| **Mailchimp**      | `*\|FNAME\|*`           | `*\|EMAIL\|*`       |
| **HubSpot**        | `{{contact.firstname}}` | `{{contact.email}}` |
| **SendGrid**       | `{{firstName}}`         | `{{email}}`         |
| **ActiveCampaign** | `%FIRSTNAME%`           | `%EMAIL%`           |

### Step 3: Embed in Your Email

Add the personalized link to your email campaign as either:

**A text link:**

```html theme={null}
<a href="https://app.cardclan.io/viewcard/{cardId}?name=*|FNAME|*">
  View your card
</a>
```

**A button:**

```html theme={null}
<a href="https://app.cardclan.io/viewcard/{cardId}?name=*|FNAME|*"
   style="background-color: #FF3C69; color: white; padding: 12px 24px;
          text-decoration: none; border-radius: 6px; display: inline-block;">
  View Your Card
</a>
```

**With a card cover image:**

```html theme={null}
<a href="https://app.cardclan.io/viewcard/{cardId}?name=*|FNAME|*">
  <img src="{card-cover-image-url}" alt="Your card" width="600" />
</a>
```

## Using CardClan's Built-in Email Delivery

For the best experience with full tracking and personalization, use CardClan's native sending:

1. **Add recipients** — upload via CSV with merge tag columns, or add individually
2. **Configure sender** — use the default CardClan sender or connect your own SMTP/Gmail/Office 365 account
3. **Customize the email** — set header text, footer text, button color, and branding from workspace settings
4. **Send or schedule** — send immediately or set a future date/time

Each recipient automatically gets:

* A unique `recipientId` in their link for tracking
* Personalized greeting with their name
* Card cover image preview in the email
* A branded unsubscribe link

## Engagement Tracking

Every personalized link enables per-recipient analytics:

| Metric          | Description                                                |
| --------------- | ---------------------------------------------------------- |
| **Email Opens** | Tracked when the email is opened (pixel tracking)          |
| **Card Views**  | Tracked when the recipient clicks through to view the card |
| **Downloads**   | Logged when a recipient downloads the card as PNG or PDF   |
| **Reactions**   | Recipient reactions to the card                            |
| **Comments**    | Comments left by recipients on the card                    |

Access analytics from the card dashboard or via the analytics API endpoints.

## Custom Domain Support

If you have a custom domain configured (white-label), all personalized links automatically use your domain:

```
https://yourbrand.com/viewcard/{cardId}?recipientId={recipientId}
```

This removes CardClan branding from URLs and emails. See the [White Label Setup](/help/white-label-setup/white-label-setup) guide for configuration steps.

## Unsubscribe Handling

Every card email includes a personalized unsubscribe link:

```
https://yourdomain.com/unsubscribe?cardId={cardId}&workspaceId={workspaceId}&recipientId={recipientId}
```

When a recipient unsubscribes:

* They are marked as unsubscribed for that workspace
* Future emails from that workspace are blocked
* The unsubscribe status is visible in your recipient list

<Info>If you have any queries, feel free to reach out in live chat.</Info>