Lede Docs

How Newsletters Are Represented in Beehiiv

Overview

Beehiiv is the email service provider that powers newsletter delivery for the Lede platform. Each newsletter that you manage in the Publisher App is represented in Beehiiv as a newsletter list. This article explains how that mapping works.

Newsletter Lists

When you create a newsletter in the Publisher App, Lede automatically creates a matching newsletter list in your Beehiiv publication and links the two. The list is named after the newsletter’s display name. You can see your lists in Beehiiv under Subscribers → Newsletter lists.

  • Renaming a newsletter in the Publisher App renames its list in Beehiiv.
  • Deleting a newsletter archives its list in Beehiiv. Lede never deletes a list.

A subscriber is opted into a newsletter when they are an active member of its list. Lede adds and removes subscribers as their preferences change on your website or in the Publisher App, and Beehiiv notifies Lede when a subscriber joins or leaves a list through Beehiiv’s preferences page or an unsubscribe link, so both systems stay in agreement.

To send an issue of a newsletter, choose its list as the email audience. See Sending to a Newsletter in Beehiiv.

Legacy Newsletter Custom Fields

Your Beehiiv publication also has a true/false custom field for each newsletter, named Newsletter: [Display Name]. These fields come from the way Lede tracked newsletters before Beehiiv supported newsletter lists. Lede still updates them when a preference changes on your website or in the Publisher App, but not when a subscriber changes newsletters in Beehiiv.

Because they can be out of date, don’t use the Newsletter: [Display Name] custom fields to choose who receives a newsletter, to build segments, or to trigger automations. Use the newsletter’s list instead.

Other Custom Fields

Lede also syncs a number of other subscriber details to Beehiiv as custom fields, which you can use to build segments that narrow a send:

  • Customer Status — the subscriber’s account status.
  • Product Name — the name of the subscriber’s current subscription product.
  • Order Interval — whether the subscription is monthly or annual.
  • Order Expiration — the expiration date of the current subscription.
  • Order Canceled and Order Cancel On Expiration — whether the subscription has been canceled, or is set to end when it expires.
  • Order Coupon Applied — whether a coupon was used on the subscription.
  • Donor — whether the subscriber has made a donation.
  • Gift Purchased and Gift Received — whether the subscriber has bought or been given a gift subscription.
  • Last Login and Ever Logged In — when the subscriber last logged in to your site, and whether they ever have.
  • Content Categories, Content Tags and Content Authors — the subscriber’s reading interests, updated nightly. See Customer Sync Between Lede and Beehiiv.

Lede manages these fields. Edits made to them directly in Beehiiv may be overwritten the next time Lede syncs the subscriber.

Was this article helpful?