---
updatedAt: 2026-11-09T09:59:05.000Z
agentTools:
  projectIndex: https://docs.esputnik.com/llms.txt
---

# Unsubscribe Forms

<HTMLBlock>{`
<p align="right" style="color: gray;">
  <a href="https://docs-ua.esputnik.com/docs/formi-vidpiski" style="color: gray; text-decoration: none;"><em>
    Read this article in Ukrainian ⮕
  </em></a>
</p>
`}</HTMLBlock>

Unsubscribe forms are web pages that users land on after clicking the **Unsubscribe** link in an email.

> 🚧 Important
>
> The unsubscribe link/footer is mandatory in every email — including transactional ones — per Google's sender requirements (February 2024). eSputnik automatically re-adds it if it's removed from a template; there's no way to turn it off. The unsubscribe link works only in a sent email, not in the editor or the preview.

Clicking **Unsubscribe**, through the button or the footer, changes the contact's system subscription status and they stop receiving emails. It doesn't update a custom contact field, such as a `consent` flag you set during your own onboarding. To keep such a field in sync, add a workflow that starts on the unsubscribe event and includes an **Update contact field** step.

## Benefits of Using Unsubscribe Forms

* **Protecting the sender’s reputation:** The form allows you to end the communication neatly, leaving the user with a positive impression of the brand.
* **The ability to save the contact:** Instead of an instant unsubscribe, you can offer an alternative, for example, a thirty-day pause or changing [subscription categories](https://docs.esputnik.com/docs/how-to-use-subscription-categories).
* **Analytics of reasons for unsubscribing:** Contacts can indicate the reason for unsubscribing, allowing you to improve content and communication in the future.
* **Flexible brand experience:** The ability to customize the form allows you to design it according to your design, style, and user language.

<Callout icon="📘" theme="info">
  Unsubscribe forms are available upon request. Please contact us at [support@esputnik.com](mailto:support@esputnik.com) to activate the functionality for your account.
</Callout>

## Why the Form Address Can't Be Copied

The unsubscribe link in a template is not a fixed address. At send time it is wrapped into a short link that is unique per recipient, and that link is what identifies whom to unsubscribe or re-subscribe. The same is true of the subscription form.

Copying the form's address into an email you assemble and send yourself therefore doesn't work: the link isn't wrapped, so the page has no contact to act on. For the same reason a wrapped link is personal — passing yours to someone else won't unsubscribe them — and a page opened through an unwrapped link can't fill in personalization, so merge tags stay on screen as raw text.

The wrapped link sits on the account's link-shortening domain, so the unsubscribe link carries the same domain as every other tracked link in your messages. To have it on a domain of your own, set up a custom one — see [Short Links Settings](https://docs.esputnik.com/docs/creating-a-custom-domain-for-url-shortening). There is no separate domain setting for the unsubscribe link.

To keep this form while sending over the API, send a template created in the platform — with [Send prepared message](https://docs.esputnik.com/docs/using-the-send-prepared-message-api-method), for example. The link is then wrapped exactly as in a regular campaign. If you would rather keep sending from your own system, host the page yourself and call the unsubscribe event from it, as described in the next section.

Whichever way you send, the global "unsubscribed from all" status is available only in the account UI. [Get contact](https://docs.esputnik.com/reference/getcontact-1) and [Search contacts](https://docs.esputnik.com/reference/searchcontacts-1) return the contact card, but not the system email-subscription or blacklist status — so a consent field of your own is never the same thing as the system suppression status. See [Contact Blacklist](https://docs.esputnik.com/docs/contact-blacklist) for what the API does and does not expose.

If the message body has to stay in your own system, the email still needs a way to opt out. A line of plain text with a working reply address is enough — for example, "If you no longer want to receive these emails, write to us at …". Use an address people can actually reply to, not a `noreply` one. An email with no opt-out at all gets the sender blocked, and mailbox providers start filing its mail as spam, which pulls down the open rate and the reputation of the whole domain.

## Using Your Own Unsubscribe Page

Instead of a form built in eSputnik, you can send contacts to a page hosted on your own domain. To do this, your page must trigger the eSputnik unsubscribe event when the user confirms — call the [Add to Unsubscribed](https://docs.esputnik.com/reference/addtounsubscribed-1) (or [Delete from Unsubscribed](https://docs.esputnik.com/reference/deletefromunsubscribed-1) to reverse it) API method from your page. Without this call, the contact will be removed from your own list but will still be considered subscribed in eSputnik and keep receiving messages.

## Form Types

1. **Double Opt-Out Form:** The contact first sees a page with the option to leave a comment and choose a reason for unsubscribing. The final unsubscription occurs after confirmation.

<Image align="center" width="60% " src="https://files.readme.io/c6611c3a8dcde43ef561515967680886e1e610e7ccbf07389891cb5d44cbcdf8-image3.png" alt="Double Opt-Out unsubscribe form main page listing reasons for unsubscribing with a radio button selected and the Unsubscribe button" />

The form includes the following pages:

* Main page
* Successful unsubscribtion

2. **Opt-Out Form:** The contact is immediately unsubscribed but can leave feedback, after which they will be offered the options to subscribe again now or in 30 days.

<Image align="center" width="60% " src="https://files.readme.io/789a01965f3c741be2d1bfbdd511b6c3bbb98e368a334e61f48bb806bd2a82f0-image10.png" alt="Opt-Out unsubscribe form page confirming the successful unsubscription with a Resubscribe button and a feedback text field" />

The form includes the following pages:

* Main page
* Contact sent feedback
* Contact subscribed again
* Contact paused subscription for 30 days

> 📘 Note
>
> The **Double Opt-Out** form has no resubscribe page, so a contact who used it can't resubscribe themselves. Resubscribe options are available only in the **Opt-Out** form.

## Changing Basic Settings

After activation, the default forms are ready to use. In most cases, you don't need to create them from scratch — just make a few basic changes:

* Replace the default image with your logo.
* Add your own text and [language versions](https://docs.esputnik.com/docs/unsubscribe-forms#multilanguage) of the form.
* Adapt the colors of the buttons and texts to your brand palette.

> 📘 Note
>
> All basic changes can be implemented without deep technical knowledge. **This is safe**, and the form's functionality **will not be affected**.
>
> If you make more profound changes to the code, **you risk breaking the form** — for example, the unsubscribe may not be recorded, but the contact will remain active in the mailing list. Therefore, deep customization should only be done with the appropriate technical knowledge or with the help of a developer.

## Creating an Unsubscribe Form

1. Go to your account settings → **Unsubscribe forms** section → **Forms** → click **New form**.

<Image align="center" width="80% " src="https://files.readme.io/64341b59cc074c7c20695f4ea457217706d8230c6bbc1b478cd00257ffe924e4-image.png"  alt="Unsubscribe forms page with the Settings menu, Unsubscribe forms navigation item, and New form button highlighted" />

2. Select the form type (**Double Opt-Out** or **Opt-Out**) and how you want to create it:

* **Default template:** Сustomize the existing code.
* **From scratch:** Add your HTML.

<Image align="center" width="80% " src="https://files.readme.io/063c3aceebd58479be78dafea079581bdcfe9899b6ee9b489566621fdedb1b08-image.png"  alt="New unsubscribe form dialog with Double Opt-Out and Opt-Out options, and Default template or From scratch choices" />

### Required Code Snippets

1. The **Double Opt-Out** form must contain code that performs the unsubscribe after clicking the button:

<Image align="center" width="80% " src="https://files.readme.io/9105815c4862e135602f533f72eb1b5d3fb3272fa8a3d49b6ee1332d7758ea33-image.png"  alt="Double Opt-Out unsubscribe form code with the hidden button input and Unsubscribe submit button code highlighted" />

2. The **Opt-Out** form must contain code that performs **re-subscription** and **leaving feedback**.

* **Main page**:

<Image align="center" width="80% " src="https://files.readme.io/1fa47f8ff1b2220d5f9bb698d5870f7a72d3f8117bdd4e468cb6c5897e36ed3a-image.png"  alt="Opt-Out unsubscribe form main page code with Re-subscribe and Leave feedback button code highlighted" />

* **Contact Sent Feedback** page:

<Image align="center" width="80% " src="https://files.readme.io/f1a7704e2789c8741008719ac789c463bff85bb83402b988a4b60954a3ad5865-image.png"  alt="Opt-Out form Contact sent feedback page code with Re-subscribe and Subscribe in 30 days button code highlighted" />

<Callout icon="❗️" theme="error">
  Avoid deleting service items and scripts
</Callout>

### Multilanguage

Forms support [multiple languages](https://docs.esputnik.com/docs/multilanguage-overview).

<Image align="center" width="80% " src="https://files.readme.io/cce2787952718eef149f00a9efb5259757a91d15be117b49029c5878e5b87652-image.png"  alt="Double Opt-Out unsubscribe form editor with the language selector dropdown highlighted" />

The language is determined automatically in the following order:

1. The language specified in the message.
2. The user's browser language.
3. The language from the contact's profile.
4. The default form language.

### Setting CSS Styles

You can customize the CSS styles of your form in two ways:

1. Upload the CSS file and add a link to it on each form page.
2. Add the CSS code directly to the HTML code of each form page.

> 📘 Note
>
> Adding CSS styles is not required, but is recommended, as HTML without styles may not display correctly.

#### Using CSS file

1. Go to the **CSS** tab and click **New CSS file**.

<Image align="center" width="80% " src="https://files.readme.io/4705d5f1ba41b5ad02b6182aca4fbcc92647b114a27101ee5f502b15e731fc30-image.png"  alt="Unsubscription forms CSS tab with the New CSS file button highlighted" />

2. Upload the appropriate file.

<Image align="center" width="80% " src="https://files.readme.io/b15c1f71c9534d5a374fb87957b5ab11d8110a81b51cc041bd6ea757f2a1389e-image.png"  alt="CSS file upload area with drag-and-drop or click-to-upload option highlighted" />

2. Copy the link to the file.

<Image align="center" width="80% " src="https://files.readme.io/2f901f8d83f3318bcd7406784828cc83146e0e0920dce352faafc0a3f2d91ce7-image.png"  alt="CSS files list with the copy link icon highlighted next to an uploaded file" />

3. Specify a link to the file in the HTML code **of each form page**.

<Image align="center" width="80% " src="https://files.readme.io/823a34c42010b3f8a9e451389faa76b98c36599f7be29d53c136cd365f592bf4-image.png"  alt="Unsubscribe form HTML code with the CSS stylesheet link tag highlighted" />

#### Adding CSS code

Add CSS code directly **on each form page**.

<Image align="center" width="40% " src="https://files.readme.io/8efac7cfc7f83f7a059df1701a7f882100250e437b1e2f3e0a1111db3b57af24-image.png"  alt="Form HTML code with a CSS style block highlighted inside the head section" />

### Changing Favicon

A favicon is a small icon that appears in a browser tab.

<Image align="center" width="40% " src="https://files.readme.io/79684b7d43d0bea345256c5f0a8585b1d94788b4be5981ed742a226515428463-image16.png" alt="Browser tab showing the unsubscription form's favicon next to the page title" />

To change the form and email favicon, follow the instructions [at the link](https://docs.esputnik.com/docs/adding-a-favicon-for-emails-web-version).

## Testing and Publishing

Copy the form’s link and follow it to view the created form in the browser.

<Image align="center" width="80% " src="https://files.readme.io/31513e19221e78321d771673ba25bc238f346cbb85b58bd6abf853864077208c-image.png"  alt="Unsubscription forms page with the preview link icon highlighted next to the published form" />

Click **Publish** so your contacts start going to the unsubscribe form.

<Image align="center" width="80% " src="https://files.readme.io/afa837398c26306f45640ce1f40197d94dbd7bf5e949d8f62237f323ddf13a4d-image.png"  alt="Unsubscription forms page with the Publish button highlighted for an unpublished form" />

> 📘 Note
>
> * A published form applies to all email messages.
> * Only one unsubscribe form can be published.
> * While the form is published, it cannot be deleted.

## One-Click Unsubscribe Headers

The `List-Unsubscribe` and `List-Unsubscribe-Post` headers, which let mailbox providers show their own one-click unsubscribe, are added automatically to all emails, both bulk and triggered. You do not configure them.

Whether the button appears is up to the mailbox provider: Gmail may not show it even when the headers are correct.

A link from the `List-Unsubscribe` header can also be opened directly — an anti-spam bot, for example, visits every link in an email. Such a request opens a confirmation page, and the contact is unsubscribed only after clicking the button on it. The mailbox provider's own button sends a POST request and unsubscribes right away.