# 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.

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).

> **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.

## 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.