Hello there! This page is a quick reference to help you get started with Buttondown.

There are two main sections: "Just the basics" and "Advanced setup". If you have never set up your own newsletter before, the "Just the basics" section is for you. It tells you only the necessary steps to complete to get your newsletter up and running. If you're familiar with managing newsletters on the internet, or you want to dig into more complicated features, read "Just the basics" and then check out "Advanced setup".

Just the basics

This section is intended to help you get your newsletter up and running in the fewest possible steps. Everyone should read this section, and you can stop here if you've never published a newsletter online before or don't have time to configure some of Buttondown's more advanced features.

Everyone should read the following topics:

There are a lot of other topics in the "Getting started" section, and if you want even more information, you can read them all. But these three topics will help you create your newsletter, make it look nice, and get ready to send to your subscribers.

Advanced setup

If your newsletter is up and running, you can optionally configure some of Buttondown's more advanced features. You can complete the procedures in these topics in any order, and you can do as many or as few of them as you like.

  • Crafting your newsletter's look and feel has a lot of information about how to personalize your newsletter's appearance.
  • Importing your data will help you bring subscribers from any previous newsletter hosting service you may have used.
  • Sending from a custom domain and Hosting on a custom domain. If you own your own domain (learn more about that in Getting a custom domain), you can use it to send and host your Buttondown newsletter. Sending from a custom domain has some benefits in terms of open and click-through rates, so definitely consider checking out that topic.
  • Paid subscriptions. Use Stripe and Buttondown together to collect payments from your subscribers, either at regular intervals or with a pay-as-you-wish model.
  • Tags. You might want to segment your subscribers with tags. This can help you control which updates your subscribers receive, or even run multiple newsletters with the same set of subscribers.
  • RSS-to-email. This topic will help you use RSS to automate your newsletter. You can automatically send your subscribers a new email every time you publish a new post, podcast episode, or other content.
  • API reference: Introduction. If you prefer to avoid the WYSIWYG experience, check out Buttondown's API. You can download the whole spec from that topic.
  • Billing. And last but not least, if you want to unlock all of Buttondown's premium features and understand how much you might spend on the service, the Billing documentation is well worth your time.