Lede Docs

Newsletter Opt-In and Opt-Out

Overview

When a subscriber opts into or out of a newsletter, the change is recorded in both the Lede platform and Beehiiv. This article explains how the opt-in/opt-out process works and how data stays in sync across both systems.

How Opt-In and Opt-Out Work

Each subscriber’s preference for each newsletter is tracked as an intent — a record that links the subscriber to a specific newsletter and stores whether they are active (opted in) or inactive (opted out).

Each newsletter is a newsletter list in Beehiiv. When a subscriber’s preference changes, the platform immediately updates their membership in that list:

  • Opt in: the subscriber is added to the newsletter’s list.
  • Opt out: the subscriber is removed from the newsletter’s list.

Lede also updates the older Newsletter: [Name] custom field when the change is made on your website or in the Publisher App, but not when it is made in Beehiiv. Always use the list, not the custom field, to target a newsletter; see Sending to a Newsletter in Beehiiv.

Where Can Subscribers Change Their Preferences?

Subscribers can opt in or out of newsletters in several ways:

Through Your Website

Your Lede-powered website includes newsletter preference controls where logged-in subscribers can manage which newsletters they receive. Changes made here are synced to Beehiiv automatically.

Through Beehiiv’s Preferences Page

Beehiiv provides a built-in subscriber preferences page where subscribers can manage their email preferences. If a subscriber changes their newsletter selections through this page, the change is sent back to Lede via webhook (and also reconciled at the subscriber’s next login). See Subscriber Preferences and Unsubscribe Requests for details on how to configure which newsletters appear on this page.

Default Newsletter Opt-In

When a new subscriber registers or purchases a paid subscription, they are automatically opted into your publication’s default newsletter. This happens whether the subscriber registers through your website, through a Stripe checkout flow, or through any other supported registration method.

Premium Newsletter Auto-Enrollment

Newsletters marked as premium are automatically enabled for subscribers when they purchase a paid subscription that includes the premium newsletter entitlement. Paid subscribers do not need to manually opt in to premium newsletters — it happens automatically when their subscription is created.

Was this article helpful?