# Unsubscribe link

### How to include an unsubscribe link?

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

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://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/unsubscribe%20ui.png" alt=""><figcaption></figcaption></figure>

### How would it look to me?

When one of your recipients unsubscribe, you will know it through the tracking status of your campaign :

<figure><img src="https://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/tracking%20unsubscribe.png" alt=""><figcaption></figcaption></figure>

### Insert the standardized unsubscribe footer :

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

<div><figure><img src="https://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/insert%20footer.png" alt=""><figcaption></figcaption></figure> <figure><img src="https://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/unsubscribe%20footer.png" 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.

Here's how to do it:

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://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/insert%20link.png" alt=""><figcaption></figcaption></figure> <figure><img src="https://github.com/mailmergehow/mailmergehow-documentation/blob/main/.gitbook/assets/unsubscribe%20link.png" 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://support.mailmergehow.com/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.
