Notify guides
20 · Hosted preference page

A preference page you don't have to build.

People who only read your emails can still choose what they get: Notify hosts the page, in your colours, behind a signed link.

<NotifyPreferences/> is for people signed in to your app. Someone who only gets your emails has no session, so the link in the email footer has to open a page that works on its own. Notify hosts that page for every recipient.


1

What the page does

  • One switch per category and channel your types actually use (in-app, email, mobile push, browser push). Channels a category marks mandatory show as required; categories with only critical types say they are always sent.
  • Quiet hours (your workspace default, none, or their own window) and a time zone.
  • Unsubscribe from everything except required messages.
  • Opening the link changes nothing: link scanners and previews are safe. Saving is a button. Every change is recorded in the recipient's consent history with the source hosted_page.
  • No script, no tracking, nothing loaded but your logo. It follows light and dark mode.

2

It is already in your emails

Every non-critical email Notify sends in a non-transactional category carries one-click List-Unsubscribe headers (RFC 8058) that point at this page. Gmail and Yahoo show an Unsubscribe button; pressing it turns that category's email off, and never touches Mail's suppression list, so security notices still arrive. Opening the same link shows the whole page, with a one-click button for that category.

Your Mail template gets the link too, for the footer: {{{preferences_url}}}.


3

A link for anywhere else

Make one for an account page, a support reply, or emails you send yourself. Links last 365 days; erasing the recipient makes them a dead page at once. Anyone holding a link can change that person's preferences, so send it only to them.

preference-link.ts
// A signed link (valid a year) to the page Notify hosts for this person:
// categories per channel, quiet hours, time zone, unsubscribe from everything.
const link = await notify.recipients.createPreferenceLink("user_123", {
  category_key: "product-updates", // optional: offers one-click unsubscribe from it
});
console.log(link.url, link.expires_at);

4

Your brand

Name, logo, accent colour and privacy link, in Notify › Settings (or "Use my Mail brand"), or from code. Text on the accent switches between black and white, whichever reads better.

branding.ts
await notify.settings.update({
  branding: {
    name: "Acme",
    logo_url: "https://acme.example/logo.png",
    accent_color: "#4f46e5",
    privacy_url: "https://acme.example/privacy",
  },
});