# Unsubscribe links

How the unsubscribe link works: the {{unsubscribe}} template token, the configurable opt-out prefix, your own unsubscribe domain with the same DNS setup as short links, the opt-out text required per country, and how opting out connects to a contact's consent.

**Language:** en
**Audience:** platform
**TLDR:** To include the unsubscribe, add the {{unsubscribe}} token to your message: at send time Instasent renders it as the opt-out wording each country requires plus the link (e.g. "STOP to opt-out" in the US). You can configure a per-channel opt-out prefix and use your own unsubscribe domain (same DNS setup as short links). When used, the contact's consent records an opt-out.
**Translation key:** platform.project-settings.unsubscribe-links
**Search keywords:** unsubscribe links, unsubscribe link, unsubscribe, opt-out, opt out, stop, unsubscribe domain, opt-out prefix, unsubscribe keyword, compliance, consent, unsubscribe token
**Related pages:** /platform/es/project-settings/unsubscribe-links, /platform/en/project-settings/short-links-branded-domain, /platform/en/consent, /platform/en/consent/opt-outs-reactivation, /platform/en/channels/compliance-defaults
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/en/llms.txt
**This page:** https://docs.instasent.com/platform/en/project-settings/unsubscribe-links/ (HTML) · https://docs.instasent.com/platform/en/project-settings/unsubscribe-links.md (Markdown)
**Other language (es):** https://docs.instasent.com/platform/es/project-settings/unsubscribe-links.md

An unsubscribe link gives your contacts a one-tap way to stop receiving your messages — and including one is a legal requirement in most countries. Instasent generates the link for you and inserts it into your messages; you control the wording around it and, if you want, the domain it uses. You'll find this under **Settings → Tools → Unsubscribe links**.

## How the link is inserted

You don't paste an unsubscribe link by hand. You add the **`{{unsubscribe}}`** token to your message, and Instasent renders it at send time: a tappable URL for RCS, and for SMS the localized opt-out text plus the link. The same model produces the right wording for each channel.

The required opt-out text varies by country. For example, the United States and Canada use *"STOP to opt-out"*, and France uses *"STOP au #sms#"*. Instasent applies the wording each destination requires.

## The opt-out prefix

You can configure a word that precedes the unsubscribe link — the **opt-out prefix** (the field is labelled **Prefix**). It's **empty by default** — only the unsubscribe link is added — and can be up to 64 characters. The prefix is set per channel, alongside the channel's opt-out keywords, reply handling and scope.

![The unsubscribe settings with the opt-out prefix field](/platform/en/project-settings/images/unsubscribe-links--1.png)
*The unsubscribe settings, with the opt-out prefix field.*

## Your own unsubscribe domain

By default, the unsubscribe link uses a generic Instasent domain. You can replace it with your own branded domain so the link carries your name. The setup is the same as for short links — you add a domain you own (an apex domain like `stop-myshop.com`, or a subdomain like `stop.myshop.com`) and create the DNS records the panel shows.

{/* Editors: the production default unsubscribe domain is `nosms.to`, taken from the
    production ConfigMaps, consistent across api, dr and process, and corroborated by the
    shipped panel build. Deliberately NOT named in prose, applying the same criterion as the
    short-link domain on the Short links & branded domain page: the
    value is confirmed as configured, but liveness could not be proven independently (no
    ingress rule, TLS certificate manifest or managed external DNS in the Infra repo).
    Publish the literal here once that is confirmed. `nosms.inst.to` and `devnosms.inst.to`
    are develop values and are never authoritative for customers. */}

The DNS records, the two setup modes and the verification flow work exactly as described for short links — see [Short links & branded domain](/platform/en/project-settings/short-links-branded-domain#setting-up-a-branded-domain). Each unsubscribe domain also has a **Default redirect URL**: your business's main webpage, or a page explaining how to unsubscribe.

## What opting out does

When a contact uses the unsubscribe link or replies with the opt-out keyword, Instasent records the opt-out on their consent: they no longer receive marketing on that channel, and they're excluded from campaigns by default. The full model — marketing preference versus channel suppression, who can re-subscribe a contact, and how an opt-out escalates — is in [Consent & subscriptions](/platform/en/consent).

{/* VERIFY: the exact consent attribute/state the opt-out writes (cross-check with the consent collection), and the unsubscribe landing page the contact sees. */}

> **Note**: The opt-out prefix, the unsubscribe domain and the opt-out keywords are set **per channel**. There is no per-campaign unsubscribe configuration — it applies at the project and channel level.

{/* VERIFY: the state of the per-channel cascade — opt-out prefix and unsubscribe domain are configured at project level today, with a per-channel split pending on the backend. */}

## Permissions

Anyone signed in can view the unsubscribe settings. Adding a branded unsubscribe domain is subject to your plan's limit, and the write actions — setting a domain active, archiving — require the project-write permission.

For per-country defaults and what each channel asks for out of the box, see [Compliance defaults](/platform/en/channels/compliance-defaults).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.