Creating & Sending Email Broadcasts
Channel staff (owner, editor, moderator) and the channel's signed-in subscribers can draft a broadcast. A draft is private to its author and the channel staff until it is submitted for moderation; only sent broadcasts appear in the public archive.
Step 1: Open the Broadcasts Page
- Sign in to the Listserv application.
- Open the channel's Broadcasts page from the top navigation.

Step 2: Start a New Draft
- Click New Broadcast.
- The compose form opens. Nothing is written until you click Create broadcast, so leaving the form creates no draft.
Step 3: Compose the Broadcast
- Enter the Title — the name the broadcast carries in the admin list.
- Enter the Subject — the email subject line subscribers receive.
- Compose the body using Markdown. Headings (
# Title), bold (**text**), links ([label](url)), lists and blockquotes are supported.
WCAG 2.1 AA Accessibility Defaults
Broadcast emails are generated as semantic HTML with contrast ratios meeting WCAG 2.1 AA and fallback text styles for legacy email clients. Write descriptive link labels and use headings in order.
Step 4: Create the Draft
- Click Create broadcast (disabled until every required field is filled).
- The broadcast is saved as a
draftand its editor opens. Channel staff continue in the Admin broadcast editor; subscribers continue in their submission editor. - The draft's status is
draft: it is not visible to subscribers. Each broadcast you create counts toward the channel's hourly cap (rateLimit.maxPerHour), drafts included.
Step 5: Submit or Send
- Review the draft in the editor, then click Save to keep your changes.
- Click Submit to send the broadcast for moderation.
- The broadcast lifecycle state updates:
draft→submitted→detectingLanguage→translating→moderated- A channel moderator approves (→
sending→sent) or rejects (→rejected, returned to the author for editing).
- During
sending, the background engine dispatches localized versions to channel subscribers via Mailgun mailing lists.
Not yet available in the editor
The broadcast model supports layout templates, a primary language and file attachments, but the compose and edit forms currently expose only title, subject and body.