From a first draft to the send report.

Write in an editor built for email and the web, check how it looks in an inbox, choose who gets it, and watch it go out. Every step below is the real dashboard.

  1. Step 1

    Start from a template, or a blank page

    Press New post and choose a blank post, a template, or a copy of your latest post. Eight starters come with Swarm, each written as a guide to itself: use it, then replace the words with your own.

    • Your own templates: save any post as a template, or import an HTML email you already use.
    • A content calendar with planned dates for drafts, which never schedule anything by themselves.
    Starters in Templates: Personal letter, Weekly roundup, Long-form essay, Announcement or launch and more, each with a description and Use and Preview buttons.
    The starter templates that come with Swarm.
  2. Step 2

    Write in an editor made for email

    Fill in the subject and preview text and watch the inbox preview change. Then write: the toolbar has text styles, links, lists, quotes and merge tags, and Insert (or / on an empty line) adds blocks.

    Your work saves as you type, and every save is kept in History, where you can name, compare and restore versions.

    The post editor: preview modes, Subject with 26 of 200 characters, empty Preview text with a hint, an Inbox preview from Mara at Field Notes, Add cover image, the toolbar and the start of the post.
    Subject, preview text and the inbox preview, above the post.
    Blocks in the editor
    BlockWhat it is
    Image, FileFrom your media library or a new upload, with alt text
    Button, Link cardA large link, or a link shown as a card
    Quote, Callout, DividerFor structure and emphasis
    Two columns, Embed, FootnoteSide by side, a video or audio player on the web, a numbered note
    PollA question readers answer with one click
    Paywall breakEverything below it is for paying subscribers (the paywall)
  3. Step 3

    Preview it as readers will see it

    Switch between Edit, Email · desktop, Email · mobile, Email · dark and Web. With paid plans, View as shows the post as a free or a paid subscriber.

    • Send a test to yourself and up to 5 teammates. It arrives with [Test] in the subject, and its links are not tracked.
    • Emails built for every mail app: one frame that handles Outlook on Windows, dark mode and phones, checked in a browser so far.
    The editor in Email mobile preview: From Mara at Field Notes, the subject Notes on the popup economy, and the post in a narrow column as a phone shows it.
    The email as a phone shows it.
  4. Step 4

    Choose who gets it, check, and send

    The panel beside the editor has three stops, always in this order. Who gets it is a deliberate choice: everyone, some segments, or segments to leave out. Nobody gets the same post twice.

    • The checks must pass before the send button works, and a disabled button says why.
    • Send to N subscribers, then confirm. While it goes out you can stop it; emails that left stay sent.
    The send panel: Write done with 37 words and a paywall break placed, Who gets it done with Everyone, 12,731, and Check and send with Send now, the checks, a warm-up note, Send a test and Send to 12,731 subscribers.
    The send panel, with the send button last.
  5. Step 5

    Schedule it, or send at each reader's best time

    Choose Schedule, set the date and time in your time zone, and confirm. The checks run again at send time; if something is not ready, the post goes back to draft and Home tells you.

    • Best-time sending: within 24 hours of your time, each reader gets the post at the hour they most often opened or clicked in the last 90 days.
    • Readers with little history, and anyone who asked not to be tracked, get the time you chose.
    The send panel with Schedule chosen: a date and time field, your time zone, the checks and a Schedule for Tue 17 Nov, 02:00 button.
    Scheduling a post from the send panel.
  6. Step 6

    Test two subjects before everyone gets one

    Under More options, choose a split test of the subject line and preview text, or of the content. Two or three versions go to part of the audience; the winner, by opens, clicks or a goal, goes to everyone else.

    A test needs enough people to mean anything. With a list of a few hundred, the difference between two subjects is mostly chance.

    Test before sending: Split test, testing the subject line and preview text, Variant A as written, a Variant B subject, Add variant C, and 20% of the audience so each variant goes to about 10% and the other 80% get the winner.
    A split test of the subject line.
  7. Step 7

    Watch the send report

    The report opens as soon as you send and updates while the post goes out. It counts people, not machines: privacy proxies such as Apple Mail and company link scanners are counted apart.

    • Delivered, opened, clicked, unsubscribed, bounce rate, complaint rate, failed, and an estimate of the sending cost.
    • Links with the people who clicked each one, and a click map of the email as it went out.
    • Send again to people who didn't open, as a new draft with the same content.
    A send report: What the river taught us about deadlines, Delivery 12,731 of 12,731 at 100%, Delivered 12,617, Opened by people 50.1% with 900 privacy proxies apart, Clicked 600 with 56 scanners apart, Unsubscribed 9.
    A finished send report.

Read the full writing and sending guide

Write your first post on your own install.

Swarm is free and open source. Install it on your Cloudflare account and follow Getting started to your first send.

Install from a terminal
git clone https://github.com/jntegz/swarm-newsletter.git swarm
cd swarm && pnpm install
pnpm swarm

Want to look first? pnpm swarm --dry-run shows every step and changes nothing.