Unsubscribe

How email unsubscribes work and how to customize the unsubscribe page.

It is crucial to provide email recipients with the ability to unsubscribe from your email broadcasts in order to maintain a good sender reputation.

Giving recipients the ability to unsubscribe from your email broadcasts:

reduces the likelihood that your emails are marked as spam
improves deliverability for your email broadcasts

In Quotient, use the Unsubscribe Link component in your email footer to give recipients the option to unsubscribe from your emails. Quotient also includes a List-Unsubscribe header on outgoing emails, so many inbox providers can show a native one-click unsubscribe button.

One-click unsubscribe (inbox provider button): The inbox provider calls Quotient's unsubscribe endpoint. The person is unsubscribed without needing to load a confirmation page.
Footer link unsubscribe: The person lands on your branded unsubscribe page and confirms by clicking the unsubscribe button.

What Happens When Someone Unsubscribes

Quotient immediately updates that person's marketing state to UNSUBSCRIBED. From that point forward, they are excluded from marketing sends, even if they still appear in a list or segment.

Marketing States

State	Description
`SUBSCRIBED`	Opted in. Will receive marketing emails.
`NOT_SUBSCRIBED`	Has not opted in. Will not receive marketing emails.
`UNSUBSCRIBED`	Explicitly opted out. Will not receive marketing emails.
`PENDING`	Subscription pending confirmation.

Customizing the Unsubscribe Page

You can customize the copy on your unsubscribe page in Email Settings:

Dark mode — enables a dark unsubscribe page treatment
Show logo — controls whether your brand logo appears on the page
Accent color — sets the unsubscribe button color
Heading — defaults to "Unsubscribe from [Brand Name]"
Subheading — defaults to "You're currently subscribed to emails from [Brand Name]."
Button text — defaults to "Unsubscribe"

Quotient also provides a preview so you can check how the page looks before saving changes.