Hosting domains

components/Sidebar/NavigationHierarchy.tsx

@@ -9,6 +9,7 @@ import {
   QuestionMarkCircleIcon,
   TerminalIcon,
 } from "@heroicons/react/outline";
+import { GlobeAltIcon } from "@heroicons/react/solid";
 
 export type NavigationSubitem = {
   name: string;
@@ -116,6 +117,17 @@ const NAVIGATION: Array<NavigationItem> = [
       },
     ],
   },
+  {
+    name: "Sending domain guides",
+    href: "/sending-domains",
+    icon: GlobeAltIcon,
+    children: [
+      {
+        name: "Sending from DreamHost",
+        href: "/sending-domains/sending-from-dreamhost",
+      },
+    ],
+  },
   {
     name: "Migration guides",
     href: "/migration-guides",

pages/advanced-features/monetizing-your-newsletter.mdx

@@ -84,14 +84,14 @@ If you go to your [subscribers](https://buttondown.email/subscribers?order=-crea
 If you want to provide a link in your emails to each subscriber's paid archive, you can use the following shortcake:
 
 ```html
-{{ premium_archive_link }}
+{{ premium_archive_url }}
 ```
 
 This generates a unique-per-subscriber ID for their paid specific paid archives. Like the link generated through Buttondown's interface, it will expire once the subscriber's paid subscription lapses. A common tactic is to reference it in your footer for _all_ paid subscribers, like so:
 
 ```html
 {% if subscriber.subscriber_type == "premium" %} You can always view your full
-archives [here]({{ premium_archive_link }}). {% endif %}
+archives [here]({{ premium_archive_url }}). {% endif %}
 ```
 
 ## FAQs

pages/getting-started/hosting-domains/hosting-on-dnsimple.mdx

@@ -0,0 +1,69 @@
+---
+title: Hosting on a custom domain - DNSimple
+description: "A step-by-step guide: setting up a custom domain to host your newsletter with DNSimple"
+---
+
+import Layout from "../../../components/Layout";
+import Notice from "../../../components/Notice";
+
+export const meta = {
+  title: "Hosting on a custom domain - DNSimple",
+  description:
+    "A step-by-step guide: setting up a custom domain to host your newsletter with Host",
+};
+export default ({ children }) => <Layout meta={meta}>{children}</Layout>;
+
+# Hosting on a custom domain - DNSimple
+
+<Notice variant="info">
+Hosting on a custom domain?!  What is this? Why is it important?  <a
+    className="text-green-800 underline"
+    href="https://docs.buttondown.email/getting-started/hosting-on-a-custom-domain"
+  >This guide will explain everything.</a>
+</Notice>
+
+1. Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”.
+
+2. Enter your custom hosting domain.
+
+    ![](/images/hosting-domains/hosting-domain.png)
+
+3.  Scroll to the bottom of the page and click on the blue "Update settings" bar.
+4. Scroll back up to where you entered your custom hosting domain.  Look for the red alert.  Click on the "Click here" link. 
+    ![](/images/hosting-domains/red-alert.png)
+5. In a new tab, log into your DNSimple account.  
+    1. From the menu on the left, click on the name of the domain you want to send emails from.  
+    2. Select "DNS" from the menu on the left (orange circle in screenshot below).
+    3. In the DNS records section, click "Manage"(green circle on the right in screenshot below).
+
+    <img src="/images/sending-domains/dnsimple-navigation.png" width="70%" />
+6. Click on the "ADD A RECORD" button. (Red circle on the left in screenshot above.)
+7. Add the CNAME record - Take the information from the Buttondown popup and put it into DNSimple:
+
+   1. Click the blue "Add Record" button.
+   2. Choose "CNAME" from the drop-down menu.
+   4. In Buttondown, copy everything before ".fictile.space" from the "KEY" column.  In DNSimple, paste it in the "Name" field. (Pink arrow on the left in screenshot below.)
+   5. In Buttondown, copy everything from the "NEEDED" column.  In DNSimple, paste it in the "Content" field.  (Green arrow on the right in screenshot below.)
+
+    ![](/images/hosting-domains/dnsimple-add-cname-record.png)
+
+8. If it were tea, you’d wait for it to steep. But it’s computers, so DNSimple can take up to 24 hours to process your update. This is a good opportunity to enjoy a cup of tea.
+
+9. Click “Check records” in Buttondown. If it gives you a green checkmark, that means your DNS records are done propagating. You’re good to go!
+
+<Notice variant="info">
+<b>See Also:</b> <a
+    className="text-green-800 underline"
+    href="/getting-started/sending-domains/sending-from-dnsimple"
+  >Sending from DNSimple</a> if you want to send emails from a custom domain (like <tt>[email protected]</tt>).
+</Notice>
+
+##  Troubleshooting
+
+### Did you get an HTTPS error when you tried to go to your custom hosting domain?
+
+This is normal and temporary.  Your DNS records are still propogating!
+
+###  Are your DNS records still propagating?
+
+I know setting up DNS records is a pain! If it's been 24 hours and you're still not seeing the records get validated in the way you expect, <a href="mailto:[email protected]">email me</a> and I'm happy to help!

pages/getting-started/hosting-domains/hosting-on-dreamhost.mdx

@@ -0,0 +1,66 @@
+---
+title: Hosting on a custom domain - DreamHost
+description: "A step-by-step guide: setting up a custom domain to host your newsletter with DreamHost"
+---
+
+import Layout from "../../../components/Layout";
+import Notice from "../../../components/Notice";
+
+export const meta = {
+  title: "Hosting on a custom domain - DreamHost",
+  description:
+    "A step-by-step guide: setting up a custom domain to host your newsletter with DreamHost",
+};
+export default ({ children }) => <Layout meta={meta}>{children}</Layout>;
+
+# Hosting on a custom domain - DreamHost
+
+<Notice variant="info">
+Hosting on a custom domain?!  What is this? Why is it important?  <a
+    className="text-green-800 underline"
+    href="https://docs.buttondown.email/getting-started/hosting-on-a-custom-domain"
+  >This guide will explain everything.</a>
+</Notice>
+
+1. Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”.
+
+2. Enter your custom hosting domain.
+
+    ![](/images/hosting-domains/hosting-domain2.png)
+
+3.  Scroll to the bottom of the page and click on the blue "Update settings" bar.
+4. Scroll back up to where you entered your custom hosting domain.  Look for the red alert.  Click on the "Click here" link. 
+    ![](/images/hosting-domains/red-alert.png)
+5. In another tab, go to your [DreamHost Control Panel](https://panel.dreamhost.com/?tree=domain.manage). From the menu on the left, make sure you are in “Domains” > “Manage Domains”. Click “DNS” under the domain name you are setting up with Buttondown.
+
+    ![](/images/sending-domains/dreamhost-webpanel-navigation.png)
+6. Add the CNAME record - Take the information from the Buttondown popup and put it in DreamHost:
+
+   1. Click “Add Record”
+   2. Click the “CNAME” box.
+   3. In Buttondown, copy everything before ".buttondown.xyz" from the "KEY" column.  In DreamHost, paste it in the "Host" field. (Pink arrow on the left in screenshot below.)
+   4. In Buttondown, copy everything from the "NEEDED" column.  In DreamHost, paste it in the "Points to" field. (Green arrow on the right in screenshot below.)
+   5. Click “Add Record”.
+
+    ![](/images/hosting-domains/dreamhost-add-cname-record.png)
+
+8. If it were tea, you’d wait for it to steep. But it’s computers, so DreamHost can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea.
+
+9. Click “Check records” in Buttondown. If it gives you a green checkmark, that means your DNS records are done propagating. You’re good to go!
+
+<Notice variant="info">
+<b>See Also:</b> <a
+    className="text-green-800 underline"
+    href="/getting-started/sending-domains/sending-from-dreamhost"
+  >Sending from DreamHost</a> if you want to send emails from a custom domain (like <tt>[email protected]</tt>).
+</Notice>
+
+##  Troubleshooting
+
+### Did you get an HTTPS error when you tried to go to your custom hosting domain?
+
+This is normal and temporary.  Your DNS records are still propogating!
+
+###  Are your DNS records still propagating?
+
+I know setting up DNS records is a pain! If it's been 24 hours and you're still not seeing the records get validated in the way you expect, <a href="mailto:[email protected]">email me</a> and I'm happy to help!

pages/getting-started/hosting-domains/hosting-on-godaddy.mdx

@@ -0,0 +1,69 @@
+---
+title: Hosting on a custom domain - GoDaddy
+description: "A step-by-step guide: setting up a custom domain to host your newsletter with GoDaddy"
+---
+
+import Layout from "../../../components/Layout";
+import Notice from "../../../components/Notice";
+
+export const meta = {
+  title: "Hosting on a custom domain - GoDaddy",
+  description:
+    "A step-by-step guide: setting up a custom domain to host your newsletter with GoDaddy",
+};
+export default ({ children }) => <Layout meta={meta}>{children}</Layout>;
+
+# Hosting on a custom domain - GoDaddy
+
+<Notice variant="info">
+Hosting on a custom domain?!  What is this? Why is it important?  <a
+    className="text-green-800 underline"
+    href="https://docs.buttondown.email/getting-started/hosting-on-a-custom-domain"
+  >This guide will explain everything.</a>
+</Notice>
+
+1. Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”.
+
+2. Enter your custom hosting domain.
+
+    ![](/images/hosting-domains/hosting-domain2.png)
+
+3.  Scroll to the bottom of the page and click on the blue "Update settings" bar.
+4. Scroll back up to where you entered your custom hosting domain.  Look for the red alert.  Click on the "Click here" link. 
+    ![](/images/hosting-domains/red-alert.png)
+5. In another tab, log in to your [GoDaddy Domain Control Center](https://dcc.godaddy.com/domains?showAdvanceListView=true&).  Click the "..." next to the domain name you are setting up with Buttondown (pink circle in screenshot below), and click "Manage DNS" in the dropdown menu (orange circle in screenshot below).
+
+    ![](/images/hosting-domains/godaddy-webpanel-navigation.png)
+6. Add the CNAME record - Take the information from the Buttondown popup and put it in GoDaddy:
+
+   1. In GoDaddy, click “Add”. (Orange circle in screenshot below)
+
+    ![](/images/hosting-domains/godaddy-add-record.png)
+
+   2. In the "Type" dropdown menue, select "CNAME" (Orange arrow on the left in screenshot below)
+   3. In Buttondown, copy everything before ".buttondown.xyz" from the "KEY" column.  In GoDaddy, paste it in the "Name" field. (Pink arrow in the middle in screenshot below.)
+   4. In Buttondown, copy everything from the "NEEDED" column.  In GoDaddy, paste it in the "Value to" field. (Green arrow on the right in screenshot below.)
+   5. Click “Add Record”.
+
+    ![](/images/hosting-domains/godaddy-add-cname-record.png)
+
+8. If it were tea, you’d wait for it to steep. But it’s computers, so GoDaddy can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea.
+
+9. Click “Check records” in Buttondown. If it gives you a green checkmark, that means your DNS records are done propagating. You’re good to go!
+
+<Notice variant="info">
+<b>See Also:</b> <a
+    className="text-green-800 underline"
+    href="/getting-started/sending-domains/sending-from-godaddy"
+  >Sending from GoDaddy</a> if you want to send emails from a custom domain (like <tt>[email protected]</tt>).
+</Notice>
+
+##  Troubleshooting
+
+### Did you get an HTTPS error when you tried to go to your custom hosting domain?
+
+This is normal and temporary.  Your DNS records are still propogating!
+
+###  Are your DNS records still propagating?
+
+I know setting up DNS records is a pain! If it's been 24 hours and you're still not seeing the records get validated in the way you expect, <a href="mailto:[email protected]">email me</a> and I'm happy to help!

pages/getting-started/hosting-domains/hosting-on-google-domains.mdx

@@ -0,0 +1,67 @@
+---
+title: Hosting on a custom domain - Google Domains
+description: "A step-by-step guide: setting up a custom domain to host your newsletter with Google Domains"
+---
+
+import Layout from "../../../components/Layout";
+import Notice from "../../../components/Notice";
+
+export const meta = {
+  title: "Hosting on a custom domain - Google Domains",
+  description:
+    "A step-by-step guide: setting up a custom domain to host your newsletter with Google Domains",
+};
+export default ({ children }) => <Layout meta={meta}>{children}</Layout>;
+
+# Hosting on a custom domain - Google Domains
+
+<Notice variant="info">
+Hosting on a custom domain?!  What is this? Why is it important?  <a
+    className="text-green-800 underline"
+    href="https://docs.buttondown.email/getting-started/hosting-on-a-custom-domain"
+  >This guide will explain everything.</a>
+</Notice>
+
+1. Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”.
+
+2. Enter your custom hosting domain.
+
+    ![](/images/hosting-domains/hosting-domain3.png)
+
+3.  Scroll to the bottom of the page and click on the blue "Update settings" bar.
+4. Scroll back up to where you entered your custom hosting domain.  Look for the red alert.  Click on the "Click here" link. 
+    ![](/images/hosting-domains/red-alert.png)
+5. In another tab, go to your [Google Domains Control Panel](domains.google.com/).   If you have more than one Google domain, use the domain name you want to send Buttondown emails from.
+
+6. From the menu on the left, click “DNS”. 
+
+    ![](/images/sending-domains/Google-Domains-webpanel-navigation.png)
+
+7. Take the information from the Buttondown popup and put it in Google Domains:
+
+   1. In Buttondown, copy everything before ".hebetu.de" from the "KEY" column.  In Google Domains, paste it in the "Host name" column. (Pink arrow on the left in screenshot below.)
+   2. Choose CNAME from the dropdown "Type" menu.
+   3. In Buttondown, copy everything from the "NEEDED" column.  In Google Domains, paste it in the "Data" column.  (Green arrow on the right in screenshot below.)
+
+     ![](/images/hosting-domains/hosting-on-google-domains2.png)
+
+8. If it were tea, you’d wait for it to steep. But it’s computers, so Google Domains can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea.
+
+9. Click “Check records” in Buttondown. If it gives you a green checkmark, that means your DNS records are done propagating. You’re good to go!
+
+<Notice variant="info">
+<b>See Also:</b> <a
+    className="text-green-800 underline"
+    href="/getting-started/sending-domains/sending-from-google-domains"
+  >Sending from Google Domains</a> if you want to send emails from a custom domain (like <tt>[email protected]</tt>).
+</Notice>
+
+##  Troubleshooting
+
+### Did you get an HTTPS error when you tried to go to your custom hosting domain?
+
+This is normal and temporary.  Your DNS records are still propogating!
+
+###  Are your DNS records still propagating?
+
+I know setting up DNS records is a pain! If it's been 24 hours and you're still not seeing the records get validated in the way you expect, <a href="mailto:[email protected]">email me</a> and I'm happy to help!

pages/getting-started/hosting-domains/hosting-on-hover.mdx

@@ -0,0 +1,69 @@
+---
+title: Hosting on a custom domain - Hover
+description: "A step-by-step guide: setting up a custom domain to host your newsletter with Hover"
+---
+
+import Layout from "../../../components/Layout";
+import Notice from "../../../components/Notice";
+
+export const meta = {
+  title: "Hosting on a custom domain - Hover",
+  description:
+    "A step-by-step guide: setting up a custom domain to host your newsletter with Hover",
+};
+export default ({ children }) => <Layout meta={meta}>{children}</Layout>;
+
+# Hosting on a custom domain - Hover
+
+<Notice variant="info">
+Hosting on a custom domain?!  What is this? Why is it important?  <a
+    className="text-green-800 underline"
+    href="https://docs.buttondown.email/getting-started/hosting-on-a-custom-domain"
+  >This guide will explain everything.</a>
+</Notice>
+
+1. Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”.
+
+2. Enter your custom hosting domain.
+
+    ![](/images/hosting-domains/hosting-domain.png)
+
+3.  Scroll to the bottom of the page and click on the blue "Update settings" bar.
+4. Scroll back up to where you entered your custom hosting domain.  Look for the red alert.  Click on the "Click here" link. 
+    ![](/images/hosting-domains/red-alert.png)
+5. In a new tab, log into your Hover account. 
+6.  Click on the DNS tab. (Orange circle on the right in screenshot below.)
+    ![](/images/hosting-domains/hosting-on-hover.png)
+7. Click on the "ADD A RECORD" button. (Red circle on the left in screenshot above.)
+8. Take the information from the Buttondown popup and put it in Hover:
+
+    1. Select “CNAME” from the "type" dropdown menu.  (Green arrow on the left in screenshot below.)
+
+    2. Enter the "KEY"" from Buttondown where Hover asks for “HOSTNAME”. (Red arrow in the middle in screenshot below.)
+
+    3. Enter the “NEEDED” from Buttondown where Hover  asks for “TARGET NAME”. (Blue arrow on the right in screenshot below.) 
+
+     4. Click "ADD RECORD".
+
+     ![](/images/hosting-domains/hosting-on-hover2.png)
+
+9. If it were tea, you’d wait for it to steep. But it’s computers, so Hover can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea.
+
+10. Click “Check records” in Buttondown. If it gives you a green checkmark, that means your DNS records are done propagating. You’re good to go!
+
+<Notice variant="info">
+<b>See Also:</b> <a
+    className="text-green-800 underline"
+    href="/getting-started/sending-domains/sending-from-hover"
+  >Sending from Hover</a> if you want to send emails from a custom domain (like <tt>[email protected]</tt>).
+</Notice>
+
+##  Troubleshooting
+
+### Did you get an HTTPS error when you tried to go to your custom hosting domain?
+
+This is normal and temporary.  Your DNS records are still propogating!
+
+###  Are your DNS records still propagating?
+
+I know setting up DNS records is a pain! If it's been 24 hours and you're still not seeing the records get validated in the way you expect, <a href="mailto:[email protected]">email me</a> and I'm happy to help!