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 buttondown.email.Hosting on a custom domain means using a domain other than buttondown.com to host your newsletter and archives on the web.
Sending from a custom domain means sending outgoing emails from your domain, improving reputation and delivery metrics.
A custom hosting domain requires you to sign up for either Standard or Professional plans. Sending from a custom domain is available to everyone, because sending emails that actually get delivered is pretty important, and it's scummy to hide that behind a paywall.
Buttondown offers a “managed” experience for connecting a sending domain. (Your sending domain is the domain that you send emails from — for example, anything@yourdomain.com).
The “managed” experience requires giving Buttondown control over a subdomain of your domain, which you will only use for Buttondown. We recommend that users use mail.example.com or newsletter.example.com, but you can use any subdomain you’d like.
The advantage of "managed" is that Buttondown can continuously update your DNS configuration to verify your domain with a growing number of email-sending partners. As a result, we can shift your newsletter's email traffic across those partners to balance deliverability and reliability, and in case of outages.
If you don't use the "managed" DNS setup (also known as the "manual" setup), everything will work just fine, but we won't be able to switch your newsletter between different email-sending partners for optimal performance.
There is no need to change your sending domain configuration if you're already set up. Your current configuration will be supported indefinitely. However, we suggest using the “managed” process for new sending domains.
NS type records that are shown to you in Settings.example.com) rather than a subdomain (newsletter.example.com)?Since the "managed" setup takes over a subdomain, it requires a subdomain that you can dedicate to Buttondown — whether that's newsletter.example.com, buttondown.example.com, bd.example.com, or otherwise.
If you want to send from your root domain (example.com), you're very welcome to. You will not see the "managed" DNS option in settings; instead, you'll only see the "manual" records.
You're welcome to do so! Just add your sending domain in Settings and, when presented with the list of DNS records to add, switch to the "managed" version of the records.