Skip to main content
A broadcast is a one-time email sent to a specific group of recipients. Unlike triggered workflows that run automatically based on events, broadcasts let you send announcements, promotions, or updates on your schedule.
Broadcasts typically have Allow unsubscribe turned on. Each Send Email step is tied to a reusable topic such as Product updates, Newsletter, or Promotions, and recipients can:
  • unsubscribe from just that topic
  • unsubscribe from all optional email for your project
  • manage all topics from a hosted unsubscribe page
Dreamlit adds email-client unsubscribe headers automatically. To include the link in the email itself, add {{ dreamlit_unsubscribe_url }} in the body or footer. For the full model behind topics, unsubscribe-all, and the hosted unsubscribe page, see Managed unsubscribe.

​
What broadcasts are for

Broadcasts are ideal for:
  • Product announcements: Let users know about new features or updates.
  • Promotions: Send limited-time offers or discounts.
  • Company news: Share milestones, events, or important updates.
  • Re-engagement: Reach out to inactive users with a compelling message.
Dreamlit supports broadcasts only to people who have explicitly opted in or have an existing relationship with you. Cold outbound (first-contact unsolicited) campaigns are currently not supported because our upstream email service, AWS SES, does not allow it. We are working on a solution with another provider for cold outbound; reach out for beta access if you’re interested.

​
Building a broadcast

  1. Go to the Broadcasts section in the sidebar.
  2. Start a conversation with the AI by describing what you want to send. For example:
    • “Send an email to all my free tier users with a promo code”
    • “Announce our Product Hunt launch to all users”
    • “Send a holiday discount to customers who made a purchase this year”
The AI will generate a broadcast workflow for you, including the audience query and email content. From there, you can iterate by chatting with the AI or editing directly—just like building any other workflow.
Chatting with the AI is often the easiest way to refine your broadcast. Ask it to adjust the audience, tweak the copy, or change the design.

​
Allow unsubscribe

When you add or edit a Send Email step in a broadcast, Dreamlit turns on Allow unsubscribe by default. This is the right choice for most announcements, newsletters, launches, promos, re-engagement campaigns, and product updates. Turn it off only when the message is operational and recipients shouldn’t be able to opt out.

​
Understanding the recipient count

When you build a broadcast, you’ll see a badge showing the estimated number of recipients. This count is a best estimate based on the current state of your database.
The recipient count may change between when you schedule the broadcast and when it sends. New users may match your query, or existing users may no longer qualify. The final count is determined at send time.

​
Scheduling a broadcast

Before sending, you’ll set a date and time for your broadcast. Use the date picker to choose a day (up to a year out) and specify the exact time. When the scheduled time arrives, Dreamlit runs your query and sends the emails. You can monitor progress in the Activity Log. Dreamlit also checks unsubscribe preferences at send time. If someone already opted out of the selected topic (or all optional email for your project), that recipient is skipped automatically.
Need to make changes? You can cancel a scheduled broadcast anytime before the send time.

​
Explore further

Managed unsubscribe

Understand how broadcasts use topics and hosted unsubscribe handling.

Send Email

Learn how to compose and personalize your broadcast emails.

Data Query

Write queries to target the right audience for your broadcast.