Browse Docs

Jump between feature areas and guides without leaving the article.

On This Page

Jump to the section you need.

Broadcasts

Use broadcasts for newsletters, product launches, announcements, and any message you send once to selected subscribers. Compose, target, test, and send or schedule the campaign in one workflow.

12 min read

Mailrith broadcasts page showing a list of draft and sent campaigns.
The Broadcasts page lists every campaign with its current status. Open any broadcast to continue editing, review delivery stats, or duplicate it as the starting point for a new campaign.

Create a Broadcast

A broadcast is a one-time email campaign. Use broadcasts for newsletters, product announcements, event invitations, launch emails, policy updates, promotions, or any message you want to send one time to selected subscribers.

  1. Click Broadcasts in the left sidebar to open the Broadcasts page for the workspace that should send the campaign.
  2. Click Create Broadcast in the page header.
  3. If Confirm Bounce And Spam Webhooks opens, check that the named provider has bounce and spam complaint webhooks for the named connection. Click Cancel to cancel creation, or click Yes, webhooks are set up to continue. Mailrith remembers the answer for that connection.
  4. In the Select Email Template drawer, choose a blank starting point, a saved Email Template, or an admin starting point template.
  5. On the Compose step, enter the Subject that subscribers will see in their inbox.
  6. Add Preview Text when you want many email apps to show a short snippet below or beside the subject.
  7. Write the email message in Body. Use Switch Template only when you want to replace the current starting point with another template.
  8. Click Save Broadcast in the header to keep the draft without moving to the next step, or click Continue when the email content is ready for delivery settings.
Mailrith broadcasts page showing the broadcast list with draft and sent statuses
The Broadcasts page shows campaigns and their status, so you can return to drafts, review scheduled sends, or inspect sent campaign results.

Broadcasts usually follow this workflow: create the draft, write the email, preview the design, choose subscribers, select delivery settings, send a test email, and then send now or schedule the campaign for later.

Compose and Preview

The compose step controls what subscribers will see in the email. Start with a blank email, an admin-provided starting point, or one of your saved email templates. Use the email editor to add text, images, buttons, spacing, dividers, and sections.

  • Subject line: the main inbox text. Write a specific subject so subscribers understand why the email matters.
  • Preview text: the short inbox snippet shown next to or below the subject in many email apps. Use it to add context instead of repeating the subject.
  • Body content: the email message. Keep the main purpose clear, and avoid adding too many competing calls-to-action.
  • Links and buttons: check that every URL opens the intended page. Use meaningful button text instead of vague wording.
  • Personalization: use subscriber data only when you are confident the fields are present and accurate for the target subscribers.

Preview the broadcast in both desktop and mobile layouts. A design that looks good on a wide screen can still have awkward spacing, oversized images, or long button text on a phone.

  1. From Broadcasts, click the draft you want to edit.
  2. On the Compose step, write or edit the Subject, Preview Text, and Body.
  3. Add links, buttons, images, and personalization only where those elements support the main goal.
  4. Use desktop preview to check layout and spacing on wider screens.
  5. Use mobile preview to check text wrapping, button width, and image size on small screens.
  6. Open every important link before sending a test email.
  7. Click Save Broadcast before you leave the editor.

For detailed editing guidance, including images, personalization, autosave, previews, and tests, read Email Editor.

For concept guidance before you write the email, use Write the Subject and Preview Text, Write the Email Body, and Email Headers and Message Format.

Subscribers and Delivery

The subscriber selection step controls who receives the broadcast. The delivery step controls which email delivery connection sends the broadcast. Review both steps carefully because a polished email sent to the wrong subscribers is still a bad campaign.

  • Include tags: send the broadcast to active subscribers who have the selected tags.
  • Include segments: send the broadcast to subscribers who match saved live rules.
  • Exclude tags: remove subscribers who should not receive this message, such as customers who already purchased or subscribers who opted out of a topic.
  • Status protection: Mailrith avoids normal marketing sends to subscribers who are unsubscribed, bounced, complained, blocked, or otherwise not eligible.
  • Delivery connection: choose the enabled sender assigned to the workspace. The selected connection controls From name, From email, provider, and delivery event tracking.

Check the subscriber count before sending. If the count is much larger than expected, your selection may include too many subscribers because of broad OR logic or a missing exclusion. If the count is much smaller than expected, review the selected tag, segment, subscriber status, and workspace.

  1. Open the broadcast draft and click Continue from the Compose step to reach the Send step.
  2. In Connection, choose the Email Delivery Connection assigned to the current workspace.
  3. Enter a Reply To Email if replies should go to an address other than the sender address.
  4. In Recipients, choose the tags or Segments for the subscribers who should receive the campaign.
  5. Add exclusions for subscribers who should not receive the campaign.
  6. Review the subscriber count and compare it with the number you expected.
  7. Open or preview the segment if the subscriber count looks wrong.
  8. Confirm that the From name and From email match the sender details subscribers should see.
  9. In Tracking, review the defaults from Workspaces > Edit Workspace > Privacy & Consent, choose whether to keep Track Opens and Track Link Clicks enabled for this broadcast, and fill UTM fields only when your reporting system needs them.

For high-risk campaigns, create a segment first and preview the matching subscribers before you select the segment in the broadcast. A saved segment makes the rules easier to review and reuse.

If you need to decide how the sender, reply address, tracking, and UTM fields should work together, read Choose Delivery Settings, From, Reply-To, and Return-Path, and Tracking Domains, Links, and UTMs.

Test, Schedule, and Send

Always send a test email to a real inbox before you send the broadcast to subscribers. If possible, open the test email on desktop and mobile. Check the subject, preview text, images, links, buttons, personalization, spacing, footer, and unsubscribe link.

After you finish testing, choose the send option:

  1. On the Send step, use the test email area to send a test email to yourself and at least one reviewer.
  2. Open the test email on desktop and mobile.
  3. Check the subject, preview text, images, buttons, links, personalization, footer, and unsubscribe link.
  4. Return to the broadcast and fix any content or design problem you find.
  5. Review the final subscriber count and delivery connection again.
  6. To send later, turn on Schedule Broadcast, choose a future date and time, then click Schedule.
  7. To send immediately, leave Schedule Broadcast off and click Send Now. The broadcast will show as sending while Mailrith delivers it in the background.
  8. Confirm the send only when the campaign content, selected subscribers, and send time are correct.
  • Save Broadcast: use this option when the copy, design, subscriber selection, or approvals are not finished.
  • Schedule: choose a future time based on the workspace timezone. Review the timezone carefully when subscribers are in another region.
  • Send Now: start delivery to the selected subscribers. You can leave the page while Mailrith keeps sending.

After a broadcast starts sending, you cannot edit it or recall emails that have already been submitted to your delivery provider. You can request cancellation to stop Mailrith from preparing and submitting the remaining emails. If you find a problem before the scheduled send time, cancel or edit the scheduled broadcast before delivery starts.

Reuse a Failed Broadcast Safely

A failed Broadcast stays as a read-only record and cannot be sent or scheduled again. This protects Subscribers from receiving a duplicate email when some messages may already have reached the delivery provider.

  1. Click Broadcasts in the left sidebar.
  2. Find the Broadcast with the Failed status.
  3. Move your pointer over the Failed badge to read why sending failed. If you use a keyboard, press Tab until the badge is focused.
  4. In Actions, click the Duplicate Broadcast icon.
  5. Open the new Broadcast whose subject ends with (Copy).
  6. Review the content, selected Subscribers, and delivery connection before sending the new draft.

If you no longer need the failed record, you can delete it without sending it again:

  1. Click Broadcasts in the left sidebar.
  2. Find the Broadcast with the Failed status.
  3. In Actions, click the Delete Broadcast trash icon.
  4. Review the Broadcast name in the confirmation window.
  5. Click Delete Broadcast. The Broadcast disappears immediately while Mailrith safely removes its delivery records in the background.

After sending, review sent count, opens, clicks, unsubscribes, bounces, and complaints. These numbers depend on tracking settings and delivery webhook events, so make sure the delivery connection is configured correctly.

The Broadcast Statistics page shows the results available when you open it. Refresh your browser when you want to see the latest sending progress, counts, and Subscriber activity.

  1. Open Broadcasts from the left sidebar.
  2. Find the sent broadcast you want to review.
  3. Click the bar chart Broadcast Statistics button in that broadcast's row.
  4. Use Download in Clicks by Link or Subscriber Activity when you need the full CSV. Mailrith prepares the file in the background and emails you a download link when it is ready.

If this is a new sender or a larger-than-usual campaign, review Sending Volume and Warmup and Inbox Placement, Promotions, and Spam Folders before sending broadly.

Send and Monitor a High-Volume Broadcast

Mailrith uses its durable delivery system for every Broadcast and can prepare and process a Broadcast for one million Subscribers. Your email provider still controls how many emails your account can send each day and how quickly it can send them. Mailrith cannot raise those limits or recall an email the provider already accepted. Mailrith cannot guarantee that an email will reach the inbox instead of another folder.

High-volume sending does not require Mailrith to approve or enable your workspace. Before a large campaign, confirm that your delivery provider has enough quota and production access, your sender is authenticated and warmed up, and the selected Subscribers and content have been reviewed. Mailrith may pause or spread delivery across quota windows to protect the connection and other email sharing its capacity.

Understand the Readiness Checks

  • Sending quota: the number of emails your provider allows during the period it reports, such as a rolling 24-hour period, day, or month. Mailrith sends only what fits safely, keeps the remaining emails pending, and continues when more capacity is available.
  • Quota not available: some providers do not give Mailrith a trustworthy maximum and remaining figure. Mailrith shows Not Available instead of inventing a limit. Sending continues, and pending emails wait automatically if the service asks Mailrith to pause.
  • Send rate: the number of emails your provider allows each second. When the provider reports this number, Mailrith stays below it. When the provider does not report it, Mailrith starts carefully and speeds up as the provider accepts emails. If the provider asks Mailrith to slow down, Mailrith slows the connection and retries pending emails automatically. The estimated completion time changes as the safe rate changes.
  • Production access: permission from the provider to send real campaigns. A restricted or sandbox account may send only to approved test addresses.
  • Sender authentication: DNS records and provider checks that show the From domain is allowed to send. Some sending-only keys do not let Mailrith read account or domain details. Mailrith does not block a Broadcast only because that read check is unavailable, but an invalid key can still cause emails to fail when sending starts. Check SPF, DKIM, DMARC, and any provider-required setup before a large campaign.
  • Warmup: a gradual increase in sending volume that helps providers learn to trust a new sender. An approved quota for one million emails does not mean a new sender should use all of it immediately.
  • Event webhook setup: the provider connection reports bounced and complained events back to Mailrith. Mailrith asks about this when you create a Broadcast with a connection whose setup has not been confirmed. The warning does not block sending after you start a Broadcast.
  • Estimated duration: Mailrith's current estimate based on the Subscriber count, safe sending rate, and any additional quota windows the Broadcast needs. Mailrith uses the provider's next reset time when the Broadcast needs another quota window. If the selected provider does not share a sending limit, Mailrith names that provider and explains that the time uses the current sending speed only. If a paused Broadcast has no definite reset time, the estimate shows Calculating until Mailrith can confirm when sending can continue.

Start Sending

  1. Click Broadcasts in the left sidebar.
  2. Open the draft you want to send.
  3. Finish the Compose step, then click Continue to open Send.
  4. In Connection, select the email delivery connection approved for this campaign.
  5. In Recipients, review the selected tags, Segments, exclusions, and final Subscriber count.
  6. In Tracking, review open tracking, link tracking, and UTM settings.
  7. Send a test email and check the message, links, personalization, footer, and unsubscribe link.
  8. Click Send Now. Mailrith immediately creates the durable send and shows Preparing. In the background, Mailrith calculates the exact Subscriber total in small groups and checks provider access, quota, rate, and the sender status available from the provider before sending any email.
  9. If earlier Broadcasts are already using the available sending slots for the workspace or selected connection, Mailrith shows Waiting for the new Broadcast. You do not need to send it again. Mailrith starts it automatically after an earlier Broadcast finishes. Hover over Waiting to read the explanation.
  10. Open Broadcast Statistics to monitor progress. If the provider has no safe capacity left, Mailrith keeps the remaining emails pending and continues in a later quota window instead of failing the Broadcast.

Monitor Delivery Progress

  1. Click Broadcasts in the left sidebar.
  2. Click the Broadcast with the Sending or Paused status to open Broadcast Statistics.
  3. While Mailrith is preparing the Broadcast, review how many Subscribers have been prepared. The exact total is still being calculated, so Mailrith shows Preparing instead of an inaccurate percentage. After sending begins, review the accepted and prepared totals, Retrying, Skipped, Failed, Effective Rate, Estimated Completion, and Last Progress. Effective Rate measures time spent actively sending and does not count an automatic wait for more provider capacity. Estimated Completion includes known provider limits. When the selected provider does not share a limit, a warning names the provider and explains that the time can change.
  4. If Failed is greater than zero, open Subscriber Activity and click the Failed tab to see the affected Subscribers.
  5. Refresh the page when you want the latest counts, or return later. Mailrith continues sending in the background.

Prepared means Mailrith created delivery work for those Subscribers. During preparation, the number increases while Mailrith calculates the exact total. Accepted means the provider accepted the email for delivery. Accepted does not guarantee inbox placement. Retrying means Mailrith has a safe reason to try later, such as a temporary provider response or a capacity wait. Skipped means a current Subscriber protection, such as an unsubscribe, suppression, bounce, complaint, or consent rule, stopped submission.

Broadcast Statistics showing an active high-volume send with prepared, accepted, retrying, percentage, rate, and estimated completion details
Broadcast Statistics uses bounded progress totals, so you can monitor a large send without loading every Subscriber delivery into the page.

Respond to a Provider Pause

A paused Broadcast has not necessarily failed. Mailrith does not show warnings for quota checks, temporary sending limits, or capacity waits that it is handling automatically. When sending needs you to fix a confirmed issue, the progress panel names the email service, explains the issue, and tells you what to do. Do not start a second Broadcast for the same Subscribers.

  1. Open the sending Broadcast in Broadcast Statistics.
  2. Read Sending Is Paused and the pause reason.
  3. If your provider reports a definite quota reset, read Sending will resume automatically after to see that time. The estimated completion time includes this known wait.
  4. If the provider does not report a definite reset, read Mailrith will check this connection again after. Estimated Completion shows Calculating until Mailrith confirms that sending can continue.
  5. If the message asks you to fix production access, authentication, or connection setup, click Email Delivery Connections in the left sidebar, then click the selected connection's row.
  6. Contact your provider when the account quota or send rate is lower than the provider approved.
  7. Wait for automatic recovery after capacity returns. Contact Mailrith support if repeated checks do not lead to new progress.
Broadcast Statistics progress panel showing Sending Is Paused because the connection reached its safe daily sending limit
A provider pause protects the account from exceeding its safe capacity. Mailrith resumes remaining work after capacity returns.

Cancel Remaining Delivery

Cancellation stops Mailrith from submitting remaining emails. A provider request already in progress can still finish, and an accepted email cannot be recalled.

  1. Open Broadcasts, then open the sending Broadcast in Broadcast Statistics.
  2. Click Cancel Sending.
  3. Read the warning in Cancel Broadcast Sending.
  4. Click Cancel Broadcast to continue, or Keep Sending to close the dialog.
  5. Wait for Cancellation Requested. Mailrith safely finishes in-progress requests and cancels remaining eligible work.
  6. Review the final accepted and prepared totals after processing finishes. Give support the Broadcast ID if the exact canceled total is needed.
Broadcast Statistics showing Cancellation Requested and canceling progress after the user confirms Cancel Broadcast
Cancellation is a request to stop future provider submissions. It is not a recall for email already accepted by the provider.

Inspect Failed Sends

A failed send means the email service definitively rejected the email and another automatic attempt is not useful. Mailrith shows Sent with Failures when at least one email was accepted and at least one failed. It shows Failed when every email failed.

  1. Open Broadcasts, then open the completed Broadcast in Broadcast Statistics.
  2. Find Sent with Failures or Failed in the progress panel.
  3. Scroll to Subscriber Activity, then click the Failed tab. This tab appears only when at least one send failed, and Mailrith loads the affected Subscribers when you open it.
  4. Review the latest 10 failures, shown with the newest failure first. Click Next to continue through the list.
  5. Click Download to get the full list as a CSV file in the same newest-first order.

Mailrith keeps recent email activity ready for quick access, then moves older details to lower-cost archive storage. The Opened, Unsubscribed, Bounced, and Complained Subscriber Activity tabs continue to use smaller activity summaries. The Failed tab and its download also continue to show the affected Subscribers after older failure details move to archive storage.

How Subscriber Protection Works During a Large Send

Mailrith checks current eligibility again before provider submission. A Subscriber who unsubscribed, bounced, complained, became blocked, lost required consent, or is currently suppressed is skipped even if the Subscriber matched when preparation began. Provider bounce and complaint events continue to update the normal Subscriber and suppression systems after accepted email leaves Mailrith.

For a new domain, new IP, or much larger volume than usual, follow Sending Volume and Warmup. For authentication and inbox placement guidance, read From, Reply-To, and Return-Path and Inbox Placement, Promotions, and Spam Folders.

Need Help?

Reach out to the Mailrith team if you need help with anything.

Contact Us →