Skip to Content
FeaturesLeads & Newsletter

Leads & Newsletter

The Leads feature collects and stores subscriber emails (e.g. newsletter signups) per tenant and sends a welcome email when someone subscribes.

How it works

  1. A visitor enters their email in a Newsletter block on the frontend (e.g. Newsletter Section block on a page).
  2. The subscribeToNewsletter server action validates the email, finds or creates a Lead in the Leads collection (scoped to the current tenant), and optionally reactivates previously unsubscribed leads.
  3. A welcome email is sent via the email system (see Email). The email uses the tenant’s site name and URL.
  4. Leads are stored in the Leads collection. You can view and manage subscribers in the Payload admin under Leads.

Tenant scoping

Leads are tenant-scoped: each tenant has its own list. The same email can exist as a lead for different tenants. The “from” address and branding in the welcome email follow the tenant’s site email and site name (or global env defaults).

Email configuration

Newsletter emails use the same email adapter as the rest of the app (Resend API or SMTP). Configure EMAIL_ADAPTER, RESEND_API_KEY (if using Resend), and optional EMAIL_FROM / EMAIL_FROM_NAME as described in the Email feature.

  • Email — email adapter and templates
  • Content — blocks and pages (Newsletter Section block)
StorageSecurity