- View list opens the list. See The Unsubscribe List.
- Customize, next to Unsubscribe page, opens this domain’s page in the editor. See Customize the Unsubscribe Page.
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.
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.
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.
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)
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.
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:- Link. Every marketing email carries an unsubscribe link. The AI writes it as
href="#unsubscribe". Transactional mail carries none. - Sign. At send time Brew swaps the placeholder for a URL signed for that recipient and that email.
- 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.
- 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.
- RFC 8058 one-click.
List-UnsubscribeandList-Unsubscribe-Postheaders 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 thedomains 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:- Self-Service Tools
- Talk to Our Team
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.