Repository navigation
Closed
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestseverity: highMajor gap or broken flow for many usersMajor gap or broken flow for many users
Description
Background
Newsletter senders leaving beehiiv are most worried about warm-up. Examples:
- Nevo David (Postiz) on X, 17 Oct 2026: he dreads switching because he'd have to warm up email again on a new SMTP server.
- Replies in that thread asked "How do u warm up the email?", and competitors answered "Domain warm up handled automatically".
What we have today:
- Warmup scheduler #5 (Warmup scheduler) is an empty placeholder for automatic warm-up. That's a large feature.
- Write a 'SendLit with Amazon SES in ~15 minutes' guide #28 covers a "SendLit with Amazon SES in ~15 minutes" setup guide. It doesn't cover warm-up.
- Per-ESP send-rate limiting (e.g. SES max send rate) #51 covers per-ESP send-rate limiting (sends per second), not daily volume ramps.
- There are already per-team daily/monthly quotas:
organizationDeliveryPolicies.defaultDailyLimit(apps/api/src/db/schema.ts:984)quota.dailyLimiton team create/update (apps/api/src/team/queries.ts:114,307,packages/api-contract/src/schemas/teams.ts:60)- enforcement in
apps/api/src/delivery/quota.ts
- These quotas can act as a manual warm-up ramp today, but they're undocumented and there's no user-facing guidance.
We need a day-one answer before #5 ships. This blocks inviting beehiiv switchers.
Proposed fix
- Docs page "Warming up a new sending domain or SES account":
- when you don't need to warm up (you keep an existing domain/IP and reputation via your own SES/SMTP)
- SES sandbox exit and quota requests
- a sample 2-4 week ramp table, and sending to your most engaged readers first
- monitoring bounces and complaints via the Suppressions page and delivery events
- Make the existing team daily cap usable for warm-up: document it, and expose it in team settings if it isn't already user-editable on hosted.
- Link the page from Write a 'SendLit with Amazon SES in ~15 minutes' guide #28's SES guide and from onboarding.
- Leave automatic ramping to Warmup scheduler #5.
Acceptance criteria
- Warm-up docs page published on docs.sendlit.app, with a ramp table and guidance on keeping existing reputation
- A team owner can set or raise a daily send cap themselves (UI or documented API) on hosted
- Broadcasts that exceed the daily cap queue for the next day instead of failing, and this is documented (verify the current
quota.tsbehaviour) - Linked from the SES guide (Write a 'SendLit with Amazon SES in ~15 minutes' guide #28) and getting-started docs
- Warmup scheduler #5 references this as the interim solution
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationenhancementNew feature or requestNew feature or requestseverity: highMajor gap or broken flow for many usersMajor gap or broken flow for many users
Type
Projects
- StatusShow more project fieldsDone
Activity