Migration guide · beehiiv / Buttondown / MailerLite / Mailchimp / Kit / Substack

Move your newsletter list to LetterFlight, without re-asking anyone

Every guide below follows the same three moves: export from your old platform, import through Migrate from another platform in your LetterFlight dashboard — subscribers land as confirmed, no confirmation emails, no re-permissioning people who've already said yes, and unsubscribed or bounced records come with you and stay suppressed — then point your domain at us. Pick your old platform to see the specifics.

Up to 5,000 rows per migration · Suppression records travel with you · Export your list from LetterFlight any time

From beehiiv

Export: in beehiiv, go to Settings → Export Data and choose "Export All Basic Subscribers" (or "Export All Subscribers" for the fuller fields). The download link is valid for 24 hours.

Statuses in the file: active / inactive / pending / invalid / validating / needs_attention / paused / unset. The one that matters: unsubscribed people show up as inactive.

The trap: reading inactive as "just not engaged right now". It isn't — it includes everyone who opted out. Import the file as-is and our migration maps inactive to suppressed: those addresses stay on your list but we never mail them. Addresses marked invalid import as bounced, also suppressed; anything we don't recognize is held as unconfirmed rather than guessed.

Import: LetterFlight dashboard → Migrate from another platform → upload the CSV. Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below.

From Buttondown

Export: in Buttondown, go to Settings → Export. The export includes everyone — unsubscribed addresses too.

Statuses in the file: Buttondown has no single status column. Opt-out history is expressed by an unsubscription_date column (and a subscriber_type field that can carry unsubscribed / complained / undeliverable values).

The trap: assuming no status column means no opt-out history. It's there — in the dates. Import the file as-is and our migration uses unsubscription_date to keep anyone who opted out suppressed; undeliverable addresses map to bounced, also suppressed.

Import: LetterFlight dashboard → Migrate from another platform → upload the CSV. Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below.

From MailerLite

Export: in MailerLite, open your list on the Subscribers page, then export. One prep step that matters: exported columns match the columns visible in the list view, so add the Status column to the view before exporting or your file won't contain it.

Statuses in the file: Active / Unsubscribed / Bounced / Spam Complaints / Unconfirmed (the API value for complaints is junk).

The trap: exporting without the Status column and losing the complaint history. Spam Complaints (junk) is the most important one to keep — a person who complained once must never be mailed again. Import with the column present and our migration keeps Unsubscribed, Bounced and Spam Complaints addresses suppressed; Unconfirmed imports as pending.

Import: LetterFlight dashboard → Migrate from another platform → upload the CSV. Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below.

From Mailchimp

Export: in Mailchimp, go to Audience → All contacts → Export audience. You don't get one file — you get a ZIP of four CSVs, split by status: subscribed, non-subscribed, unsubscribed and cleaned (hard bounces that stopped receiving).

Statuses in the file: there is no status column — the status is the filename. The rows themselves carry columns like OPTIN_TIME and CONFIRM_TIME.

The trap: importing only subscribed.csv and throwing away the other three. unsubscribed.csv and cleaned.csv are your compliance history — import them too. Our migration accepts each file and marks its rows accordingly, so nobody in the unsubscribed or cleaned files ever gets mailed from LetterFlight.

Import: LetterFlight dashboard → Migrate from another platform → upload subscribed.csv (the regular import area's "These rows are" selector lets you state the status explicitly for the unsubscribed and cleaned files). Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below.

From Kit

Export: start the export from your Kit creator dashboard; the download link arrives by email and expires after 5 days, so grab it when it lands.

Statuses in the file: Kit's export carries a Status column (values like active / inactive / bounced / complained / cancelled — inactive means unsubscribed).

The trap: the export file only contains your subscribers — Kit doesn't hand you a separate opt-out file, so the status column is the only place opt-out history lives. Don't strip it. Import as-is and our migration keeps inactive, complained and cancelled addresses suppressed and bounced addresses as bounced.

Import: LetterFlight dashboard → Migrate from another platform → upload the CSV. Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below. Worth knowing: Kit's free plan doesn't allow a custom sending domain, so if you migrate you may be moving to your own domain for the first time — read the SPF note below carefully.

From Substack

Export: in Substack, go to Dashboard → Subscribers → Export your email list.

Statuses in the file: none that matter for suppression — Substack's export contains your current subscribers (free, paid, founding, and so on). There is no opt-out list to export; anyone who unsubscribed is already gone from the file.

The trap: expecting a suppression list to carry over. It can't — Substack's export simply doesn't include people who left. The upside: there's nothing to preserve. What you do keep is every current subscriber's consent: import through migration and nobody gets a re-confirmation email.

Import: LetterFlight dashboard → Migrate from another platform → upload the CSV. Subscribers land as confirmed, no confirmation emails. Up to 5,000 rows per migration.

Then: switch your domain and ramp your first send — see Domain & first send below.

Point your domain at us, then ramp your first send

The SPF rule that breaks sending if you skip it: a domain may carry exactly one SPF record. If your domain still has your old platform's SPF record and you add ours, you have two — that's a hard failure (SPF permerror), and nothing sends from your domain at all. Delete the old platform's SPF record, then add ours. When you verify your domain on LetterFlight (3 DNS records: SPF, DKIM, DMARC — we check your DNS directly), we'll warn you if we see an old SPF record still sitting there.

The first send is where reputation starts: importing a list sends nothing, so mailbox providers never see the CSV. The moment your first email goes out from the new setup, that's when your new sender identity starts getting graded. So don't blast the whole list on day one.

Start with your most engaged

Your first send goes to the subscribers who open everything. They generate the good signals — opens, no complaints — that a new sender needs.

Watch the two numbers

Use Google Postmaster Tools. Keep spam complaints under 0.1% (0.3% is where real damage starts) and hard bounces under 2%. Our migration keeps old opt-outs suppressed, which is half the battle.

Ramp over 1–2 weeks

Grow volume gradually across your first 1–2 weeks rather than one big blast — the standard warm-up for a new sending identity under Google and Yahoo's bulk-sender requirements.

What about unsubscribed addresses and GDPR?

Suppressions come with you so that we never mail someone who opted out — and they stay suppressed. We keep the minimum record needed to honor an opt-out (the address and its status); that retention is what unsubscribe obligations require, in line with the exception in GDPR Article 17(3)(b). Anything beyond that, you can ask us to delete. Every export from LetterFlight includes a status column, so you can see — and filter — exactly who is suppressed at any time. Suppressed records don't count against your subscriber cap.

Ready when your list is

Start free with up to 500 subscribers — migrate at your own pace. Pro is $9/month for 3,000 subscribers.

No credit card · Migration without re-confirmation · Your list exports from LetterFlight any time