# Add unsubscribe links in Email

Every marketing email must include an **unsubscribe option** to comply with email regulations and provide recipients an easy way to opt out.\
Follow the steps below to add an unsubscribe link in your message — whether you’re using the **Drag and Drop editor** or **HTML editor**.

### Add Unsubscribe Link in Drag and Drop Editor

#### Using a Text Element with Link variable

* **Open your email template** in the editor.
* Add a **Text element** where you want the unsubscribe link to appear — usually in the footer.
* In the text toolbar, click **Add Variables.**

<figure><img src="/files/PPHc2TPPkSDhy1754yLk" alt="" width="375"><figcaption></figcaption></figure>

* Click on **Links**

<figure><img src="/files/T9jbz8Jqik2oBKd5s1sX" alt="" width="375"><figcaption></figcaption></figure>

* Select **Unsubscribe**&#x20;

<figure><img src="/files/5Pij0anisqW1ycBzbJXQ" alt="" width="333"><figcaption></figcaption></figure>

* A pop-up will appear:
  * Click Wrap URL in Link as **Yes**
    * **Label** → Enter the link text that will appear in your email (e.g., *Unsubscribe*, *Click here to unsubscribe*).
    * **List (optional)** → Select a specific list if you want to support **list-based unsubscribe** (removes the contact only from that list but not global email unsubscribe)

<figure><img src="/files/apkmuLvqYsQvxZG6BbGq" alt="" width="322"><figcaption></figcaption></figure>

* If no list is selected, it will perform a **global unsubscribe** (removes the user from all email marketing communications).
* Click **Insert** to add the link.

**Note:** Bird uses a **standard unsubscribe page** where users can check a box and submit to confirm. Customization of this page is **not supported**.

#### Using a Text Element with Hyperlink

* **Open your email template** in the editor.
* Add a **Text element** where you want the unsubscribe link to appear — usually in the footer. Type your unsubscribe label text and select hyperlink from text toolbar.
* Select the Add variables **{ }** icon. You can also add **Links > Unsubscribe** variable in hyperlink

<figure><img src="/files/oOAWZLlOHG1t72AstqlA" alt="" width="375"><figcaption></figcaption></figure>

* Select Wrap URL as Text as No and insert the link variable
* The unsubscribe variable will get inserted as shown below. You can also directly type in the variable format {% unsubscribeLink %} in the hyperlink URL

<figure><img src="/files/uvfqHI0S7OghMW2DVHub" alt="" width="375"><figcaption></figcaption></figure>

#### Using a Button element

* **Open your email template** in the editor.
* Add a **Button element** where you want the unsubscribe link to appear — usually in the footer. Type your button label text.
* In the Link section, select the Add variables **{ }** icon and select **Links**

<figure><img src="/files/cctdd8sZ8xvVFMgTx20p" alt="" width="375"><figcaption></figcaption></figure>

* Then select **Unsubscribe.** Keep the Wrap Text in URL as No and click Insert

<figure><img src="/files/raJI5iz0FgDHOnfoo1Lw" alt="" width="375"><figcaption></figcaption></figure>

* Your unsubscribe link will be inserted as shown below as the button link. You can also directly type the format as {% unsubscribeLink %} in the link section.

<figure><img src="/files/DlfiNT08dJVw79QQwxzP" alt="" width="375"><figcaption></figcaption></figure>

### HTML Editor

If you’re working in the HTML editor, you can use one of the following three syntax options depending on your design preference:

| Example                                                       | Description                                                         |
| ------------------------------------------------------------- | ------------------------------------------------------------------- |
| `{% unsubscribe %}`                                           | Inserts a default unsubscribe link: `<a href="...">Unsubscribe</a>` |
| `{% unsubscribe 'Click here to unsubscribe' %}`               | Adds a link with custom text: `Click here to unsubscribe`           |
| `<a href="{% unsubscribeLink %}">Manage your preferences</a>` | Allows full HTML control (e.g., custom styles or placement).        |

Example (recommended for custom-styled emails):

```
<footer>
  <p>If you no longer wish to receive updates, <a href="{% unsubscribeLink %}">manage your preferences</a>.</p>
</footer>
```

### Things to Keep in Mind

* Always include an unsubscribe link in your marketing emails.
* Test your email to ensure the link redirects properly to Bird’s unsubscribe confirmation page.
* The unsubscribe page layout and flow are **standardized** and cannot be customized.
* Only if you use Bird's standard unsubscribe link, Bird will automatically capture the Unsubscribe event, Unsubscribe metric for reporting and update the email subscription and suppression.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/applications/content/email-templates/how-to/add-unsubscribe-links-in-email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.