# List-unsubscribe in email headers

### What is List-Unsubscribe?

List-Unsubscribe is an email header that allows recipients to easily opt out of marketing emails. It provides an additional unsubscribe method directly from their email client, such as Gmail, without having to search for an unsubscribe link within the email body.

When an email includes a List-Unsubscribe header, email providers like Gmail and Outlook display an unsubscribe option in a prominent location, making it easy for users to manage their subscriptions. This means that in some cases email recipients can unsubscribe without even opening an email.

### How List-Unsubscribe Appears in Gmail

When an email includes a List-Unsubscribe header, Gmail may display an **“Unsubscribe”** link next to the sender’s name at the top of the email. Clicking this link allows users to unsubscribe with just a couple of clicks.

<figure><img src="/files/YzTRqQcLay6fXrtS5TW8" alt=""><figcaption><p>You can see unsubscribe button on the header of the email next to sender name</p></figcaption></figure>

### Unsubscribing Without Opening the Email

Gmail also allows users to unsubscribe without even opening the email. This is useful when managing unwanted emails from the inbox view.

<figure><img src="/files/aQuHhSsGu2BjwQTVK3kJ" alt=""><figcaption><p>You can see unsubscribe button directly on inbox without even opening an email</p></figcaption></figure>

### Why List-Unsubscribe is Important

* **Better User Experience:** It makes opting out of unwanted emails easier and reduces frustration.
* **Improves Deliverability:** Emails that comply with List-Unsubscribe are less likely to be marked as spam, improving sender reputation.
* **Industry Best Practice:** Many email marketing platforms and anti-spam regulations encourage or require List-Unsubscribe implementation.


---

# 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/analytics/analytics/concepts/list-unsubscribe-in-email-headers.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.