Lede Docs

Subscriber Preferences and Unsubscribe Requests

Overview

Beehiiv provides a built-in subscriber preferences page that allows subscribers to manage their email settings. This article explains how to configure which newsletters appear on the preferences page, and the important distinction between newsletter-level opt-outs and a full platform-level unsubscribe.

Beehiiv’s Subscriber Preferences Page

Every Beehiiv publication has a preferences page that subscribers can access (typically via a link in the footer of your emails). This page allows subscribers to view and change their email preferences without needing to log into your website.

Surfacing Individual Newsletters on the Preferences Page

Each of your newsletters is a newsletter list in Beehiiv. A list only appears on the preferences page once it is set to show there, and many publications have not turned this on. To let subscribers opt in or out of individual newsletters through the preferences page:

  1. In your Beehiiv dashboard, go to Subscribers → Newsletter lists.
  2. Open the list for the newsletter you want to surface and choose Edit newsletter list.
  3. Turn on the option to show the list in the subscriber preference center, and save.
  4. Repeat for each newsletter you want subscribers to be able to manage.

Once enabled, subscribers see each list’s name and description on their preferences page and can opt in or out individually. Lede picks up these changes automatically.

The Newsletter: [Name] custom fields in Beehiiv are an older way of tracking newsletter preferences. Don’t add them to the preferences page: changes made there are not read by Lede.

Newsletter-Level Opt-Out vs. Platform-Level Unsubscribe

It is important to understand the difference between these two actions:

Newsletter-Level Opt-Out

When a subscriber turns off a specific newsletter on the preferences page (or through your website), they are opting out of that individual newsletter only. They are removed from that newsletter’s list in Beehiiv, their Beehiiv subscription remains active, and they continue to receive any other newsletters they are still opted into. The change is synced back to Lede.

The unsubscribe link in an email sent to a newsletter list works the same way: it removes the subscriber from that newsletter only.

Platform-Level Unsubscribe

Beehiiv also provides a full unsubscribe option, typically available at the bottom of emails and on the preferences page. When a subscriber uses this option, they are unsubscribing from all emails from your Beehiiv publication entirely. This is a different action from opting out of individual newsletters — it tells Beehiiv to stop sending all emails to that address.

The unsubscribe link in an email sent to a segment, rather than to a newsletter list, is also a platform-level unsubscribe. This is one reason to always send to the newsletter’s list; see Sending to a Newsletter in Beehiiv.

A platform-level unsubscribe in Beehiiv does not cancel the subscriber’s account or paid subscription on your Lede site. It only affects email delivery. The subscriber’s account, subscription status, and content access on your website remain unchanged.

Lede records a platform-level unsubscribe by opting the subscriber out of every newsletter on your site. If they later want emails again, they need to re-subscribe to your publication and then opt back into each newsletter they want.

Best Practices

  • Enable individual newsletter toggles on the preferences page so subscribers can fine-tune their preferences rather than unsubscribing entirely.
  • Communicate clearly to subscribers what the unsubscribe action means — that it stops all emails, not just the current newsletter.
  • If a subscriber contacts you about not receiving emails after an unsubscribe, check their subscription status in Beehiiv to confirm whether they unsubscribed at the platform level.
  • If a subscriber wishes to re-subscribe after a platform-level unsubscribe, this may need to be handled through Beehiiv’s interface or with assistance from Lede support.

Was this article helpful?