Skip to main content
Every marketing domain has its own unsubscribe list and an unsubscribe page. Open Domains in the sidebar and pick a domain. Its Unsubscribes card shows how many people are on the list. It splits them into people who left this domain only and people who left all of the brand’s mail. The Domains list also has a Default unsubscribe page. It’s what people see when they leave every list, or when a domain has no page of its own. Edit page opens it in the same editor.

Two Ways to Opt Out

  • This domain. The unsubscribe link puts the address on the list of the domain that sent the email. Later marketing from that domain skips it. The brand’s other marketing domains can still reach it.
  • All mail. Unsubscribe from all is a brand-wide opt-out. Every marketing send skips the contact, from every domain, and the contact shows as unsubscribed in your audience.
A domain with a transactional purpose has no unsubscribe list. Its mail carries no unsubscribe link and still reaches people who opted out. See transactional email.

The Unsubscribe List

View list shows everyone who opted out of the domain’s marketing email, with the domain’s Activity below it. Brew adds people as they unsubscribe. You can add your own by hand or from a CSV, much like adding contacts to your audience. Search by address or name, or narrow the table with its tabs:
  • All shows everyone.
  • This domain shows people on this domain’s list.
  • All mail shows the brand-wide opt-outs.
Each row shows the address, what it opted out of (this domain or all mail), how it left, and when. How it left is the unsubscribe link, one-click from the inbox, an import, the API, or added by hand. An opt-out set through the contact API has no time or source, so those columns stay blank.

Add People

Add people puts addresses on this domain’s list. Enter them one per line, or separated by commas. An address that is already a contact stops getting this domain’s marketing only. An address with no contact becomes a new contact who has already opted out of all mail.

Import a List from Another Provider

Moving from another email platform? Export its unsubscribe or suppression list as CSV, then use Import CSV on the domain that replaces the old sender. Each file can hold up to 10,000 rows. A longer file keeps its first 10,000 rows and drops the rest. Split it into files of 10,000 rows or fewer. The file needs an email column, or a single column of addresses. Addresses already on the list are skipped, so importing twice is safe.
The Subscribed column of a contact import is the all-mail opt-out. To keep an opt-out to one domain, import it here instead.

Export the List

Export all downloads the list as a CSV file.

Take Someone Off the List

Removing an address from a domain’s list lets that domain email it again. It never clears an all-mail opt-out. Only a person on your team can re-subscribe a contact who opted out of all mail, from the contact’s page. See Unsubscribes.

Activity

Under the list, Activity shows how unsubscribes from this domain have trended over the last 90 days. Use it to spot frequency problems, content mismatches, or deliverability issues before they affect your sender reputation.
  • Totals. Unsubscribes confirmed in the last 90 days, plus rolling counts for the last 30 days, 7 days, and 24 hours.
  • How they left. The total split across One-click, Confirm page, and Unattributed.
  • Trend chart. Volume over the last 30 days.
  • Top reasons. Which reason options were selected most. One-click opt-outs never give a reason.
  • How it works. The four steps in How It Works.
View unsubscribe events opens each unsubscribe in the events explorer. The explorer covers the whole brand and can’t filter by sending domain yet.

Customize the Unsubscribe Page

The unsubscribe page is what people see when they click the unsubscribe link. Unsubscribe stats live with the list, under Activity.

Design

The editor has three cards, Words, Reasons, and Look, beside a live Preview. Each card saves on its own. On a domain that uses the default page, saving any card gives the domain its own page. Revert to the default page removes it, and recipients see the brand-wide page again.

Words

What the page says. The card opens with the first few fields; the rest sit under its more link.

Reasons

Ask why people leave. Their answers show up under Top reasons in Activity.
  • Ask why people leave. Shows the reason options. People can pick more than one.
  • Require an answer. Blocks the unsubscribe until they pick a reason or write a note.
  • Let people write their own. Adds a free-text box. Box placeholder sets its hint. Default: Tell us more (optional)
Under Options, drag a reason to reorder it, or remove it. Add reason adds your own, up to the limit the card shows. Keep at least one, or turn the question off. The default options are Too many emails, Not relevant to me, I never signed up, Content quality, Found a better alternative, and Other.

Look

The page starts from your brand’s logo and neutral colors, so it fits every domain.
  • Logo. Uses your brand logo. Click Change to set a Logo URL and a Brand name for this page.
  • Colors. Neutral until you click Customize. Then set Page background, Card background, Text, Muted text, Border, Button background, and Button text.

Preview

The state tabs above the preview show each step of the page:
  • Initial. The page a contact lands on, with the reasons and the button.
  • Submitting. While the request goes through.
  • Error. What shows if the unsubscribe fails.
  • Confirmed. The screen shown after they submit.
  • Already unsubscribed. What returning visitors see if they’re already opted out.
Desktop and Mobile check the layout at both screen widths.

How It Works

The unsubscribe path needs no setup. Every marketing email Brew sends carries a signed unsubscribe link. The path runs end to end without anyone stepping in:
  1. Link. Every marketing email carries an unsubscribe link. The AI writes it as href="#unsubscribe". Transactional mail carries none.
  2. Sign. At send time Brew swaps the placeholder for a URL signed for that recipient and that email.
  3. Confirm. The recipient lands on the unsubscribe page of the domain that sent it, or your default page. Or they leave in one click from Gmail or Apple Mail.
  4. Suppress. Leaving puts the address on the sending domain’s list, and later marketing from that domain skips it. Unsubscribe from all is a brand-wide opt-out that every marketing send skips.
Two compliance details are handled automatically:
  • RFC 8058 one-click. List-Unsubscribe and List-Unsubscribe-Post headers are set on every marketing send: campaigns, audience sends, and automations on marketing domains. Gmail and Yahoo have required them for bulk senders since February 2024. Automations on a transactional-purpose domain leave them out on purpose.
  • CAN-SPAM mailing address. The footer’s address row comes from your brand’s contact details. Update it on the Brand page, under Details → Mailing address.

Start an Automation When Someone Unsubscribes

An automation can start when a contact unsubscribes from one domain’s list or from all mail. Choose When a contact unsubscribes in the trigger picker. The run sends only what the contact needs, such as a confirmation of the unsubscribe. It goes from a transactional domain, or from a marketing domain the contact is still on. See Unsubscribe Events.

From an Agent or Code

Each domain’s list is also open to the API and the MCP tools. Every route needs the domains scope. The TypeScript SDK has the same calls as brew.domains.unsubscribes, and the CLI as brew-cli domains unsubscribes. A transactional domain answers 422 DOMAIN_PURPOSE_NOT_ALLOWED. To count unsubscribes by the reason people gave, see Count Events Instead of Listing Them.

Need Help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

Search Documentation

Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.

Ask ChatGPT or Claude

Click here to open the Copy page menu at the top of this page, then send the page to ChatGPT, Claude, or your editor.