By default, your archives reside at buttondown.com/username, corresponding to the username you selected upon registering. You can view and change that username at Settings → Basics.
That archive URL always works, even if you set up a custom domain name for your archives. Put another way, if you change your archives to newsletter.example.com, visitors to buttondown.com/username will be forwarded to newsletter.example.com.
A hosting domain lets you serve your newsletter archives from your own domain, such as newsletter.janedoe.com, instead of buttondown.com/username.
After you save, Buttondown prompts you to add a CNAME record pointing to custom-domains.buttondown.com. Add this record with your DNS provider, and your custom archive URL will be live once the DNS propagates.
Looking to send emails from a custom domain? See Sending from a custom domain for setup instructions.
Let's say you're the CEO of Sheinhardt Wig Company. You have a robust and mature corporate blog at sheinhardtwig.com, but you want to send out all new blog posts as emails as well.
A standard workflow might involve you grabbing the content of your blog post (e.g. https://sheinhardtwig.com/2025/01/17/my-new-blog-post) and sending it out as an email to your subscribers. Buttondown will then create an archived version of that email to be shared on the web — at, say, https://buttondown.com/sheinhardtwig/archive/my-new-blog-post.
This has a couple problems:
In order to more harmoniously integrate Buttondown with your existing content, Buttondown allows you to set a canonical URL for every email you send. Buttondown will surface this URL rather than its own archive URL in a number of places:
<meta> tags of the email's HTML, so that search engines index the original source of the content.You can set a canonical URL in a number of ways:
Sometimes our users find a newsletter platform that better meets their needs. No hard feelings! But if you're moving away from Buttondown, you want to make sure old links to your Buttondown account don't suddenly break.
We don't have a do-it-yourself feature to enable link forwarding, but if you contact our support team, we'd be happy to set this up for you.