Buttondown Documentation
Unlike hosting your newsletter on a custom domain, which is largely a cosmetic feature, there are significant benefits to sending your emails from a custom domain.
By default, Buttondown sends your emails from its own domain and webserver. This is a good thing because it lets you focus on writing, editing, and growing your subscriber base, instead of dealing with arcane DNS issues.
However, as your newsletter matures, it might be a good idea to think about sending directly from your domain instead. This has a number of benefits:
newsletter.this-week-in-poetry.com
instead of mail.buttondown.com
.If you use DreamHost as your domain registrar, we have a step-by-step guide that will get you up and running quickly.
You might not need to set an SPF record at all! If Buttondown doesn't list it as one of the records to add, you don't need it.
SPF softfails can cause your newsletter emails to be marked as spam. A softfail SPF means the email client is suspicious of the email sender's IP address. You can help prevent this by making sure your SPF entry is configured correctly.
Depending on your newsletter configuration, you might have been asked to set up an SPF entry for your custom domain. A SPF entry is a DNS record that begins with the string:
However, you can only use this record once in a single domain. If you're using the same custom email domain for Buttondown and for an inbox provider, such as GSuite, you need to take an extra step to combine the two records.
Instead of having two separate records, like:
and
Edit the existing record to reference both domains, as shown below:
If you don't combine the two records, some mailboxes may read the first SPF entry (the GSuite one) and ignore the second (the one sent by Buttondown), which can cause a softfail and lower your newsletter email's deliverability.
Hosting on a custom domain means using a domain other than buttondown.com
to host your newsletter and archives. For example: newsletter.example.com
Sending from a custom domain means setting up your DNS records so that Buttondown sends outgoing emails from your domain, improving reputation and delivery metrics.
Hosting requires you to sign up for either Standard or Professional plans. Sending from a custom domain is available to everyone. This is because, well, sending emails that actually get delivered is pretty important, and it's scummy to hide that behind a paywall.
Unfortunately, some DNS providers do not let you set up the exact same domain or subdomain for both sending emails and as your newsletter archive.
For these DNSes, we recommend setting up completely separate subdomains. Try something like this:
newsletter.janedoe.com
for your custom newsletter domain, where readers view archives and subscribe to your newslettermail.janedoe.com
for your custom sending domain, where outgoing emails come fromThis is the best option to preserve the deliverability of your newsletter.
Yes! If you're taking advantage of Buttondown's multi-newsletter feature, you can set up multiple sending domains for each newsletter for no additional cost.
Also yes, with a caveat: Buttondown tries to be clever and detect when you're sending from the same domain on multiple newsletters. If you're doing this, we'll automatically set up the DNS records for you. If you're having trouble, email us so we can take a look.