Migration guide

Bring the subscribers. Leave the add-on bill.

Buttondown exports every subscriber in one CSV, with their type and tags, and every email as Markdown. Paid subscriptions are the one part that needs thought before you move.

Typical migration: About a day of work

In short

Moving a free newsletter from Buttondown to Bluey takes a day. Export subscribers from the Subscribers tab (click Export with nothing selected to get everyone); the CSV includes subscriber_type, tags and subscription dates. Import Regular subscribers as mailable and Unsubscribed, Undeliverable and Complained as suppressions. Your archive exports from the Emails tab as Markdown files. If you run paid subscriptions, they live in your own Stripe account, and deleting a subscriber in Buttondown does not cancel their Stripe subscription — so decide how paid readers will be handled before you switch, because Bluey does not run paid newsletters.

What transfers, and what you rebuild

Stated up front, because finding out mid-migration is how a two-day job becomes a two-week one.

WhatStatusDetail
SubscribersTransfersSubscribers › Export with nothing selected exports everyone as CSV.
Tags and metadataTransfersTags come out semicolon-separated; split them into Bluey tags on import.
Unsubscribed, Undeliverable, ComplainedTransfersIdentified by subscriber_type. Import them into Bluey as suppressions, first.
Email archivePartialEmails › Export gives a CSV plus one Markdown file per email. Republish on your own site if you want the archive public.
Paid subscriptionsRebuildBilling stays in your Stripe account. Bluey does not run paid newsletters.
AutomationsRebuildNo export is documented. Rebuild your welcome email in Bluey.
Embed formRebuildReplace the form that posts to buttondown.com with a Bluey form embed.

The migration plan, in order

  1. 1Day 1 — before any send
    Authenticate your sending domainPublish SPF, DKIM and, if you use one, DMARC records for the domain you will send from. Gmail and Yahoo have required authentication and one-click unsubscribe from bulk senders since February 2024, and an unauthenticated first send from a new platform is the fastest route to the spam folder. This is a DNS change and takes about fifteen minutes; allow up to a few hours for propagation.
  2. 2Day 1
    Export subscribers and the archiveExport subscribers with nothing selected, then export your emails from the Emails tab. Keep the Markdown files somewhere safe: deleting the account removes everything, and a snoozed newsletter does not keep its archive online.
  3. 3Day 1
    Sort by subscriber_typeUnsubscribed, Undeliverable and Complained go into Bluey as suppressions first. Regular subscribers are your mailable list. Unactivated subscribers never confirmed, so leave them out.
  4. 4Day 1
    Swap the signup formReplace Buttondown’s embed, which posts to buttondown.com, with a Bluey form on your site and any link-in-bio page.
  5. 5Week 1–2
    Run Bluey and Buttondown in parallelSplit the audience rather than duplicating it: send to one segment from Bluey and leave the rest on Buttondown. You get a like-for-like comparison of delivery, engagement and cost on your own data, and nobody receives the same campaign twice. Do not run both against the same contacts — that is the one way to make a careful migration look sloppy to your readers.
  6. 6Week 2 — gradually
    Ramp volume rather than switching itStart with your most engaged segment — people who opened or clicked in the last 30 days — and increase volume over several days. Receiving servers judge a new sending pattern partly on engagement, so leading with your best contacts builds reputation, while leading with your whole list including two-year-dormant addresses damages it. If you were on a dedicated IP, treat the new one as cold and warm it deliberately.

Mistakes people make leaving Buttondown

Each of these is recoverable, and each is much cheaper to avoid than to fix.

Leaving paid subscribers billing with nowhere to goButtondown’s paid subscriptions run on your own Stripe account, one per newsletter, and its docs say deleting a subscriber does not cancel the Stripe subscription behind it. Plan how paid readers will get their issues — or cancel or migrate their billing deliberately — before you close Buttondown.
Deleting the account before saving the archiveAccount deletion permanently removes everything. If your back issues matter for SEO or for new readers, export them and republish them on your own site first.
Leaving the suppression list behindExporting subscribers without also exporting unsubscribes, bounces and complaints is the single most common migration error. The result is that people who opted out of Buttondown receive your first Bluey campaign — which is a compliance breach in most markets and a fast way to breach Gmail's 0.3% complaint threshold on your very first send. Export suppressions and import them before anything else.

Migration FAQ

Can I move my paid newsletter to Bluey?

Bluey does not run paid subscriptions, so it suits free newsletters best. If you charge, billing stays in your Stripe account; decide how paying readers are handled before you switch.

Does my Buttondown archive come with me?

Emails export as Markdown files plus a CSV of subjects and dates. Republish them on your own site if you want a public archive.

Which subscribers should I import?

Regular subscribers as mailable. Unsubscribed, Undeliverable and Complained as suppressions. Leave Unactivated out.

Is Bluey cheaper than Buttondown?

Buttondown is free for the first 100 subscribers, then priced on a slider plus add-ons — $9 for paid subscriptions and tagging, $29 for automations. Bluey bills by emails sent, with automation included: Spark from $7 a month for 6,000 emails.

Free · 7 days

Run both in parallel. Then decide.

Seven days of full access, no credit card. Import a segment, send from Bluey while Buttondown handles the rest, and compare delivery and cost on your own data before you move the domain.