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).
When a subscriber’s preference changes, the platform immediately syncs the updated value to Beehiiv by setting the corresponding boolean custom field:
- Opt in: The custom field
Newsletter: [Name]is set to true. - Opt out: The custom field
Newsletter: [Name]is set to false.
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.