How to Migrate Your Newsletter From Substack to Buttondown

You don’t have to go with the big name in the email newsletter business. Here’s how to make the switch to a feature-rich alternative.
Black envelope on black background
Photograph: MirageC/Getty Images

Maybe you don't want to give 10 percent of your revenue to a venture-backed Silicon Valley company. Or maybe you don't trust a venture-backed Silicon Valley company to not eventually pivot away from newsletters entirely and destroy everything you built. There are all sorts of reasons you might want to leave Substack, is all I'm saying.

Some writers are leaving Substack for Ghost, which isn't an altogether natural transition. That's why I recommend (and personally use) Buttondown. Here's how you can migrate your subscribers and archive from Substack over to Buttondown.

Buttondown versus Stubstack

Buttondown offers a comparison with Substack, if you want to look at its list, but a few features stand out to me.

The first is pricing. Buttondown is free for up to 100 subscribers, after which it costs $9 a month for up to 1,000, and the price scales up from there. Substack is free but takes a 10 percent cut from any paid subscriptions, which is a big deal if you ever want to make a living from your newsletter. Imagine if you grow a subscriber base that brings in $4,000 a month—you'll be paying $400 of that to Substack. So even the most expensive tiers of Buttondown are going to cost less than that.

The second thing to think about is features. Buttondown supports all kinds of things that Substack doesn't, like autosaving. Buttondown doesn't collect user data unless you intentionally turn those features on. There's also an API and a Zapier integration, but far more important than that to me is that you can write your newsletters in markdown. (I love markdown with all of my heart.) Basically Buttondown offers all kinds of nerdy stuff that Substack doesn't.

Also: Buttondown is bootstrapped, meaning it isn't beholden to any investors. Substack has around $82 million of investor money, which means there's a powerful group of people hoping for massive growth. Call me a jaded veteran of the content mines—I freely admit that I am—but such entities rarely have the interest of journalists and writers at heart over the long term. Buttondown, meanwhile, is run by a single person—Justin Duke—who responds to emails himself and publicly reports how much money he spends running the service.

Finally, and most importantly, Buttondown sends you a fun GIF every time someone subscribes. That alone is reason to migrate over, so let’s talk about about how you can do that.

Export Your Newsletter From Substack

Log into Substack and head to the dashboard for your newsletter. Click the Settings link in the top bar. Scroll way down to the bottom to find the Export Your Data section. Click Create New Export.

Courtesy of WIRED Staff

You will get an email when the export is ready—download the ZIP file. It includes a CSV with a complete list of your subscribers and a complete archive of your previous posts

Import Your Subscribers to Buttondown

First create an account at Buttondown, if you haven't already. Configure your newsletter the way you want it and head to the subscriber page.

Click the gray Import button, right at the top. You'll see a box you can drag a CSV file to.

Courtesy of WIRED Staff

Drag the file that starts with “email_list” from the ZIP file you downloaded earlier. When the file uploads, you will see which columns in the file contain information like email address and tags. After that, all of your subscribers will be imported, meaning your Substack subscribers will get your Buttondown emails going forward.

Import Your Archive of Posts

Your subscribers are all migrated to Buttondown—now it's time to grab your archive of newsletters. Click the gray Import Archives button at the bottom of the settings page and you'll see the option to import your Substack content.

Courtesy of WIRED Staff

Drag the complete ZIP file you downloaded from Substack here, and the import process will begin. You'll get an email when the import is complete, or you can head to the archive page to check on the progress.

And just like that, you're done! You can delete your Substack account if you want, or you could leave the posts up with a note to subscribe on Buttondown—I've seen newsletters do both. Either way, you're now free of Substack.

Updated 6/8/2022 7:10 pm ET: A previous version of this story inaccurately stated that Substack recruits and pays extremists.