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

# Unsubscribe Links

> How the plugin automatically converts unsubscribe links to your ESP's merge tags on export, and how to bring your own custom merge tag

The Email Love Figma Plugin automatically converts your unsubscribe links into the correct merge tags for your email service provider (ESP). This means you don't have to memorize different syntax for each platform. Just use our simple convention and we'll handle the rest.

<iframe src="https://www.youtube.com/embed/uHtCAOMwM1Q" width="100%" height="400" frameBorder="0" allowFullScreen />

## How It Works

The plugin looks for any link in your design that points to `unsubscribe.com`. When you export your email, it automatically swaps that link for the correct unsubscribe merge tag for your chosen ESP.

The link is what matters, not the text around it. So this works whether the link is on the word "Unsubscribe," a button labeled something like "Manage preferences," or even an icon. As long as it points to `unsubscribe.com`, it gets converted on export.

### Supported Platforms

This automatic conversion works with all our out-of-the-box integrations, including:

* Braze
* Iterable
* Klaviyo
* Mailchimp
* And more

Each platform has its own specific unsubscribe syntax, and the plugin handles the translation for you.

## Step-by-Step Instructions

<Tabs>
  <Tab title="Option 1: Manual Setup">
    <Steps>
      <Step title="Add your unsubscribe text">
        Add it in your footer (or anywhere in your email).
      </Step>

      <Step title="Highlight the word &#x22;Unsubscribe&#x22;">
        Or select your button or icon.
      </Step>

      <Step title="Link it to unsubscribe.com">
        Link the selection to `unsubscribe.com`.
      </Step>

      <Step title="Export your email">
        Export and select your ESP integration. The plugin automatically converts the link to your ESP's unsubscribe merge tag.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Option 2: Use Our Pre-Built Footers">
    The fastest way to add an unsubscribe link is to use one of our standard footer components:

    <Steps>
      <Step title="Open the Email Love plugin">
        Open the plugin in Figma.
      </Step>

      <Step title="Navigate to the Footer section">
        Browse the available footers.
      </Step>

      <Step title="Choose any footer component">
        Pick one you like.
      </Step>

      <Step title="Insert it into your design">
        All our pre-built footers already include the word "unsubscribe" linked to `unsubscribe.com`, so you're ready to export immediately.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Example: Exporting with Braze

1. Select your email frame in Figma
2. Open the Email Love plugin
3. Choose **Braze** from the ESP dropdown
4. Click **Export** or **Copy Code**
5. The plugin converts `unsubscribe.com` → Braze's unsubscribe merge tag

The same process works for any of our supported integrations.

## Best Practices

**Placement:** While you can technically place the unsubscribe link anywhere in your email, it's best practice (and often legally required) to include it in the footer.

**Visibility:** Make sure your unsubscribe link is easy to find and read. Use a reasonable font size and sufficient color contrast.

**Bring Your Own Tag:** If you already know your ESP's unsubscribe merge tag, you can link directly to it in Figma and the plugin will keep it as-is on export. See **Advanced** below. And if you'd rather paste the merge tag in manually after export, that's totally fine too. The automatic conversion is just there to save you time.

## Customization

You can customize:

* The styling of the unsubscribe text (font, color, size)
* The placement within your email
* The surrounding text (e.g., "Click here to unsubscribe")

Just make sure the link points to `unsubscribe.com` (or, if you're using your own tag, your ESP's unsubscribe merge tag).

## Advanced: Bring Your Own Merge Tag

Most people should just link to `unsubscribe.com` and let the plugin handle the conversion. But if you want a specific merge tag, you can type your ESP's unsubscribe tag directly into the link field in Figma. The plugin recognizes the common unsubscribe tags for each ESP and will preserve yours exactly on export, instead of replacing it with our default.

For example:

* **Iterable:** `{{hostedUnsubscribeUrl}}`
* **Braze:** `{{${email_unsubscribe_url}}}`

…or the documented unsubscribe merge tag for your platform (Klaviyo, Customer.io, Mailchimp, HubSpot, Salesforce Marketing Cloud, and more).

A few things to keep in mind:

* Figma may automatically add `https://` in front of your tag. That's fine. The plugin removes it for you on export.
* Make sure the tag matches the ESP you're exporting to. A Braze tag won't work on an Iterable export.
* If you leave the link as `unsubscribe.com` instead, the plugin simply inserts the standard merge tag for your ESP, so existing emails keep working exactly as before.

## Need Help?

If you have questions about how unsubscribe links work with the plugin:

* **Join our Discord server** and ask in the support channel
* **Contact us** via email or Slack (for Enterprise customers)