Welcome every reader, and help them bring the next one.

Automations send the right email at the right moment, referrals reward readers who share, polls ask your list what it thinks, and a link-in-bio page turns visitors from your profiles into subscribers.

  1. Step 1

    Let emails go out on their own, at the right moment

    An automation starts when something happens to a subscriber, such as joining, confirming, buying a paid plan or going quiet, and then follows its steps. Automations lists each one with its status, its trigger, the live version, and how many people are in progress, have completed, or exited.

    • Versions: edit a draft while the live version keeps running, then publish it.
    • Runs and stats: see who went through it and how each step did. Test run sends it to one subscriber you choose.
    • Inbox rules limit automated email for each reader: per day, per week, quiet hours and the days around your newsletter. They are off until you set them.
    Automations: the Welcome series, Live, trigger Subscriber joined, live version 1, 44 in progress, 298 completed and 0 exited or failed, with buttons for Inbox rules, Templates and New automation.
    The list of automations. Sample data.
  2. Step 2

    Start from a recipe, with the emails written

    Press New automation and pick a recipe or a blank canvas. Each recipe comes with its emails already written, as a guide you replace with your own words. The Welcome email tests two versions against each other and keeps the better one.

    New automation: A recipe or Blank, then the automation recipes: Welcome email, Welcome series, Re-engagement, Paid upsell, Trial nurture and Win back, each with what starts it and how many emails it has.
    The recipes that come with Swarm.
    The automation recipes that come with Swarm
    RecipeWhat it doesEmails
    Welcome emailGreets every confirmed subscriber. Two versions are tested and the better one wins2
    Welcome seriesThree emails over the first week after a subscriber confirms3
    Re-engagementChecks in with subscribers who have not opened anything for 60 days2
    Paid upsellInvites free subscribers to a paid plan a week after they confirm2
    Trial nurtureHelps new paid subscribers get the most out of their first days2
    Win backReaches out after a paid subscription ends2
  3. Step 3

    Change any step in the visual builder

    The builder shows the automation as a path of steps. Click a step to change it, and add new ones from the list on the left.

    • Send email, delay, wait for an open or a click, branch on what you know, or split people between two paths at random.
    • Act on the subscriber: add or remove a tag, set a field, change their paid plan, or start another automation.
    • Reach outside: call a webhook, or notify the author.
    The automation builder for Welcome series: the steps you can add on the left, and the canvas with Trigger: subscriber joined, Send email: Welcome to Field Notes, Delay: wait 3 days, and Send email: The best of the archive.
    An automation in the visual builder. Sample data.
  4. Step 4

    Reward readers who bring readers

    Every subscriber gets a share link. A referral counts once the new subscriber confirms and opens a post within the days you choose, and counted referrals reach milestones, such as three or ten readers. Each milestone can give a reward once: a month of a paid plan, a coupon, or something you send by hand.

    • Guarded against fake signups: throwaway addresses can be left out, and many signups for one referrer from one network are held for someone on your team to review.
    • Suggested words for readers to share with their link, and an optional public leaderboard with first names only.
    Referral programme: Award Milestones on, must open within 14 days, hold for review after 5 signups within 24 hours, don't count throwaway email addresses, the share text; then Milestones: First three, 3 referrals, a thank-you postcard, and Ten readers, 10 referrals, a month of Supporter.
    Referral settings and two milestones. Sample data.
    The leaderboard: Priya Raman 14 counted and 2 waiting, Sam Okafor 9 and 1, Tom Reyes 6 with 1 held, Inês Costa 3 and 1.
    Referrers by counted referrals. Sample data.
  5. Step 5

    Ask your readers with polls and surveys

    A poll goes in a post as one-tap buttons: readers answer from the email itself. A survey has up to 20 questions and lives on your website. While it is open, a new answer replaces a reader's old one.

    • Answers can fill a profile field, so a segment can use them: send the next post only to the people who asked for it.
    • Results by option, limited to a segment if you like, and every answer as a CSV download.
    Results of the poll What should the next long read be about?: 1,051 respondents; Small shops online 412, 39.2%; Writing for the web 288, 27.4%; Running a site on a budget 351, 33.4%; with Download answers (CSV).
    Results of a poll from a post. Sample data.

A welcome email, step by step

More ways to grow

The other tabs of Referrals and growth, and the signup tools on your website.

Signup journeys

What new subscribers see right after they subscribe: a question, an offer to go paid or a welcome page. One live journey per form.

Series

Group posts that belong together, such as a course or a story in parts. On your website each one links to the next.

Funnel explorer

From visit to signup, confirmation, first open and paid, broken down by source, link tags, signup form or referrer.

Landing pages

A page on your website built around one signup form, with no navigation to lead people away. On the website

Signup forms

Inline, slide-in, popup or sticky bar, with confirm opt-in and a preview on desktop and mobile. In Audience

Paid plans

Trials, coupons and gift subscriptions, and the Paid upsell recipe to invite free readers. Paid subscriptions

Good to know

Growth features follow the same rules as the rest of Swarm: they only email people who can be mailed, and they keep to your tracking choices.

  • Every automated email is checked again just before it goes: someone who unsubscribed or bounced while waiting gets nothing.
  • Waits for an open or a click need tracking: with click tracking off for a publication, an automation can't start on or wait for a click.
  • Referral rewards are given only while Award Milestones is on. Referrals are recorded either way.
  • The public leaderboard stays off until you turn it on, and shows first names only.

Readers decide what they share. Someone who asks not to be tracked is never counted in opens or clicks, so a "did not open" path in an automation includes them. Check a segment of people who did not open before using it to remove anyone.

Grow without another tool on the side.

Install Swarm and start with the Welcome email recipe: it is written, tested against itself, and ready to publish.

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.