Get to the inbox, and know why when you don't.

Three things decide whether email arrives: who you are, how readers react, and what the email looks like. Swarm checks all three, step by step, and shows you each one in the dashboard.

  1. Step 1

    Send from a domain of your own

    Every install can send from its shared domain from the first minute. A sending domain of your own puts your name in the From address and builds a reputation that is yours alone. Add it under Sending & delivery, copy each record into your DNS, and press Check now.

    • DKIM signs your emails so providers can prove they were not changed on the way.
    • SPF and the bounce record say which servers send for you and where bounces go.
    • DMARC at quarantine or reject is required before a domain sends. Home shows the record to add.
    Domains: mail.fieldnotes.example, labelled Verified, Sending and DMARC quarantine, with Check now, Remove, its DMARC record and a note on warm-up.
    A verified sending domain with its records.
  2. Step 2

    Warm up a new domain, by itself

    Mailbox providers distrust a domain they have never seen. Swarm gives each new sending domain a daily limit that grows after every good day, and spreads a large send over the following days. Nobody is skipped and nobody gets it twice.

    • Engaged readers first: people who opened or clicked in the last 90 days get the day's limit before quiet readers.
    • An automatic pause when more than 2% of a day's emails bounce or more than 0.08% are marked as spam, with an email to the owners.
    • A plan for your rhythm: choose every day, a few times a week or once a week, and see the date your whole list fits in one day.
    Warm-up for mail.fieldnotes.example: Domain verified and Pace chosen done, Warming up on day 6 with 412 of 1,520 sent today, Whole list in one day on Wed 2 Dec, Complete at 1,000,000 a day, then the plan from today for a weekly sender.
    The warm-up route and the plan from today, for a weekly sender.
    Warm-up paces for a domain of your own
    PaceFirst dayGrowth after a good dayGood for
    Careful5025%A brand-new domain, or a list you have not emailed in a while
    Standard20050%Most publications. Every domain starts here
    Fast500100%A list that opens your emails often
    Custom10 to 100,0005% to 200%When you know what your domain can take
  3. Step 3

    Check every send before it goes

    The send panel runs the checks before every send and again at the scheduled time. A check that needs attention stops the send, and says why next to the button.

    • Checks: subject, content, links, sender, domain, subscribers and warm-up.
    • Inbox advice that never blocks you: subjects in capitals, repeated punctuation, public link shorteners, links that look like phishing, mostly images, very large images.
    • Size and accessibility: a warning above 102 KB, where Gmail cuts an email off, and for images without a description.
    The send panel: Write done, Who gets it done with Everyone, 12,731, Check and send open with the checks: preview text is empty, subject is set, sender domain verified, links checked, and a warm-up note saying 1,108 of 12,731 get it today and the rest over the next 4 days.
    The checks in the send panel, with a warm-up note.
  4. Step 4

    Stop mailing dead addresses, on your rules

    Every bounce is classed from what the email service and the receiving server said. You choose when an address is stopped, and Swarm shows how many subscribers new rules would stop before you save them.

    Paid subscribers are never stopped silently. Their address goes under Needs your attention, and the owners and admins get an email.

    Bounce rules: hard bounces stop at the first one (recommended) or after 2 within 30 days; soft bounces stop after 3 emails in a row; blocked and spam complaint explained; ask me before stopping a subscriber on a paid plan, ticked.
    Bounce rules, shared by every publication in the workspace.
    How Swarm treats each kind of bounce
    KindWhat it meansBy default
    Hard bounceThe address will never workStops mailing it at the first one
    Soft bounceA full mailbox, or a server asking to try laterStops after 3 emails in a row bounced softly
    BlockedRefused because of the sender, not the addressNever stops mailing the subscriber; the check-up names the provider
    Spam complaintThe reader pressed "report spam"Always stops mailing that address
  5. Step 5

    Check addresses with DeBounce

    Optional, with your own DeBounce account. Addresses are checked at signup, on import, when someone is added and across your whole list, and each gets a colour you can filter and segment on.

    Set it up with pnpm swarm enable debounce. The key stays a secret of the workers, and a whole-list check shows the credits it needs before it starts.

    How email checks work

    Subscribers with filters by email check: Green 11,602, Orange 840, Red 327 and Not checked, and a coloured dot beside each address.
    Email check colours on the Subscribers page.
    Email check colours
    ColourWhat it meansAt signup, by default
    GreenThe mailbox exists and takes emailAccepted
    OrangeAccept-all server, no answer, a team address or a throwaway mailboxAccepted
    RedWill bounce, not an email address, or a spam trapTurned away, with "Did you mean" when there is a suggestion
  6. Step 6

    Keep to your email service's limits, with nothing lost

    Tell Swarm your plan's limits per second, hour, day and month, or start from a preset. Everything the install sends counts together, and mail people are waiting for, such as sign-in links and receipts, keeps a tenth of each limit.

    • An hour or a day: the rest of the send waits and carries on by itself when the window turns.
    • A month, or a service that stops taking mail: the send pauses with everyone still waiting, the owners get an email, and an admin can choose Resume sending after the fix.
    • Never sent twice: the report says how many are left and when it continues. Do not send again.
    A send waiting: Waiting for your email service's daily limit, 1,240 left, continues at 00:00 UTC, with Resume sending and 11,491 of 12,731 sent.
    Sending limits: sent this hour, today and this month, a preset and limits per second, hour, day and month.
    A send waiting for the daily limit, and the limits form.
  7. Step 7

    Read the check-up, and fix from the top

    The Deliverability page starts with one verdict and a list of what keeps your email out of the inbox, most harmful first. Each finding says what it means, the exact steps to fix it, and links to the right setting.

    • What it looks at: your sender, DNS records, DMARC, bounce and complaint rates, mailbox providers that may be filing you as spam, warm-up, list hygiene, your footer address and domain blocklists.
    • A score out of 100 that starts at 100 and loses 20 for each problem and 5 for each warning. It is a way to see progress, not a rating from any mailbox provider.
    • Honest about limits: blocklists usually refuse automatic questions, so expect "Couldn't check" there, with a link to look your domain up yourself.
    The check-up: 20 out of 100, 3 problems to fix, 4 warnings, 1 couldn't check, 6 good. Fix these first: the DMARC policy is none, with how to fix it, then a complaint rate finding.
    A check-up with problems to fix, most harmful first.

Read the full deliverability guide

What Swarm does for you, and what it can't

Deliverability is mostly what your readers do. Swarm handles the parts software can, and tells you plainly about the rest.

  • Signs every email with DKIM and sets the return path once your records are published.
  • Adds one-click unsubscribe and a footer unsubscribe link to every newsletter, as Gmail and Yahoo require.
  • Stops mailing addresses that bounce by your rules, and every address that complains.
  • Leaves out privacy-proxy opens and link scanners, so open and click rates reflect people.
  • Collects DMARC reports and shows who is sending as your domain.
  • Unsubscribes long-inactive readers, if you turn that on. Paying subscribers are never removed.

What Swarm cannot do: see inside anyone's mailbox, see Gmail's complaint data, or change how a mailbox provider rates your domain.

For Gmail, the real complaint figure is only in Google Postmaster Tools. The deliverability guide explains it and the other free tools.

Start with a domain that is yours.

Install Swarm, add your sending domain, and let warm-up and the check-up do the rest.

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.