# Unsubscribe link

### How to include an unsubscribe link?

Please note that the 2 methods will make your email compliant with the "One Click Unsubscribe" that is recommended by [the latest guideline for bulk senders](https://blog.google/products/gmail/gmail-security-authentication-spam-protection/).

There are 2 ways to include an unsubscribe link in your template with different advantages :&#x20;

1. [Insert the standardized unsubscribe complete footer](#insert-the-standardized-unsubscribe-footer) - takes a second, and looks very standard
2. [Insert an unsubscribe link](#insert-an-unsubscribe-link) - more customizable

### How would it look for my recipients?

Whenever one of your recipients clicks to unsubscribe, they will be redirected to a page like the following:

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FzMo3tm65EtQwmriTX4KH%2Funsubscribe%20ui.png?alt=media&#x26;token=ba65e555-36a6-4cd9-98de-98d57127f6d3" alt=""><figcaption></figcaption></figure>

Also, depending on the email provider, recipients will see the "unsubscribe link" at the top of their emails. Below is an example in Apple Mail, but all the email clients have a different look.

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FnY4INXxivkwZ8wasbbeu%2Funsubscribe%20one%20click.png?alt=media&#x26;token=ab8510a5-0294-4a80-9c1a-0587009af326" alt="one click unsubscribe overview in Apple mail"><figcaption><p>This is how one-click unsubscribe will look to your recipients</p></figcaption></figure>

{% hint style="info" %}
The "One click Unsubscribe" button is not always visible, Email clients have some intelligence and they don't always display the link.&#x20;

It is very likely that if you send a test email to one of your other inboxes, it won't appear because the email client "knows" that you are regularly exchanging emails with this sender.
{% endhint %}

### How would it look to me?

When one of your recipients unsubscribes, you will know it through the tracking status of your campaign :&#x20;

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2Fc9DAFNO3gaK3vwFyIjrv%2Ftracking%20unsubscribe.png?alt=media&#x26;token=a57b0a9f-af87-4dee-9c4c-ae77cbb4b318" alt=""><figcaption></figcaption></figure>

### Insert the standardized unsubscribe footer :

1. From the template editor, click on the  "Unsubscribe footer" icon 🔕.&#x20;
2. Click on the "Insert Unsubscribe footer" button and you are done.

<div><figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FZApNRlRc79YjpR9Ejpik%2Finsert%20footer.png?alt=media&#x26;token=c1118437-be24-45df-a5c2-519d55467c01" alt=""><figcaption></figcaption></figure> <figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FD5vfxXZKdH5kW6uoTYXc%2Funsubscribe%20footer.png?alt=media&#x26;token=12b56a4a-86b8-4f5c-b8f5-563d7cdf263b" alt=""><figcaption></figcaption></figure></div>

### Insert an unsubscribe link

To add an unsubscribe link, you will need to insert the unsubscribe variable as shown below. It will be replaced by a special link that Mail Merge for Gmail uses to handle unsubscribes.&#x20;

Here's how to do it:&#x20;

1. In Mail Merge for Gmail, open your template or create a new one.
2. In the editor, add the following text "*Click here to unsubscribe*" (or any other message of your choice)
3. Select the text then click on **Insert/Edit link** 🔗
4. In the "Insert/Edit link" popup, select "Unsubscribe" in the dropdown "Link List"
5. Click "Save"

<div><figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FmAXj9E3o6m1Zf3O3Fs6i%2Finsert%20link.png?alt=media&#x26;token=63364a30-fa17-40b8-aa50-83a673d28b40" alt=""><figcaption></figcaption></figure> <figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FIFpbYHIDWXQS15KKuCVc%2Funsubscribe%20link.png?alt=media&#x26;token=169ba65a-e7ec-47b0-9fa0-d1c9a25f7da0" alt=""><figcaption></figcaption></figure></div>

When sending your emails, Mail Merge for Gmail will automatically convert the special variable with a unique unsubscribe link letting each of your contact opting-out easily, **so be careful to not change the URL by yourself.**

Please not than in the template editor, the unsubscribe link is not active.


---

# 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://documentation.merge.email/support/unsubscribe-link.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.
