diff --git a/pages/getting-started/hosting-domains/hosting-on-dnsimple.mdx b/pages/getting-started/hosting-domains/hosting-on-dnsimple.mdx new file mode 100644 index 0000000..5f19683 --- /dev/null +++ b/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 }) => {children}; + +# Hosting on a custom domain - DNSimple + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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). + + +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! + + +See Also: Sending from DNSimple if you want to send emails from a custom domain (like mail@newsletter.fictile.space). + + +## 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, email me and I'm happy to help! \ No newline at end of file diff --git a/pages/getting-started/hosting-domains/hosting-on-dreamhost.mdx b/pages/getting-started/hosting-domains/hosting-on-dreamhost.mdx new file mode 100644 index 0000000..5cff784 --- /dev/null +++ b/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 }) => {children}; + +# Hosting on a custom domain - DreamHost + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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! + + +See Also: Sending from DreamHost if you want to send emails from a custom domain (like mail@newsletter.buttondown.xyz). + + +## 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, email me and I'm happy to help! diff --git a/pages/getting-started/hosting-domains/hosting-on-godaddy.mdx b/pages/getting-started/hosting-domains/hosting-on-godaddy.mdx new file mode 100644 index 0000000..cc1a9cf --- /dev/null +++ b/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 }) => {children}; + +# Hosting on a custom domain - GoDaddy + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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! + + +See Also: Sending from GoDaddy if you want to send emails from a custom domain (like mail@newsletter.buttondown.xyz). + + +## 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, email me and I'm happy to help! diff --git a/pages/getting-started/hosting-domains/hosting-on-google-domains.mdx b/pages/getting-started/hosting-domains/hosting-on-google-domains.mdx new file mode 100644 index 0000000..787dc60 --- /dev/null +++ b/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 }) => {children}; + +# Hosting on a custom domain - Google Domains + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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! + + +See Also: Sending from Google Domains if you want to send emails from a custom domain (like mail@newsletter.hebetu.de). + + +## 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, email me and I'm happy to help! diff --git a/pages/getting-started/hosting-domains/hosting-on-hover.mdx b/pages/getting-started/hosting-domains/hosting-on-hover.mdx new file mode 100644 index 0000000..2aafe4a --- /dev/null +++ b/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 }) => {children}; + +# Hosting on a custom domain - Hover + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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! + + +See Also: Sending from Hover if you want to send emails from a custom domain (like mail@newsletter.fictile.space). + + +## 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, email me and I'm happy to help! diff --git a/pages/getting-started/hosting-domains/hosting-on-namecheap.mdx b/pages/getting-started/hosting-domains/hosting-on-namecheap.mdx new file mode 100644 index 0000000..cd90948 --- /dev/null +++ b/pages/getting-started/hosting-domains/hosting-on-namecheap.mdx @@ -0,0 +1,74 @@ +--- +title: Hosting on a custom domain - Namecheap +description: "A step-by-step guide: setting up a custom domain to host your newsletter with Namecheap" +--- + +import Layout from "../../../components/Layout"; +import Notice from "../../../components/Notice"; + +export const meta = { + title: "Hosting on a custom domain - Namecheap", + description: + "A step-by-step guide: setting up a custom domain to host your newsletter with Namecheap", +}; +export default ({ children }) => {children}; + +# Hosting on a custom domain - Namecheap + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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 Namecheap Domains List](https://ap.www.namecheap.com/Domains). Click the "Manage" button next to the domain you want to send emails from (pink circle in screenshot below). + + ![](/images/sending-domains/namecheap-webpanel-navigation.png) + +6. Click the "Advanced DNS" tab (purple circle in screenshot below). + + ![](/images/hosting-domains/namecheap-webpanel-navigation2.png) + +7. Add the CNAME record: + + 1. “ADD NEW RECORD” at the bottom of the list. (Green circle in screenshot below.) + + ![](/images/sending-domains/namecheap-add-record.png) + + 3. In Namecheap, select "CNAME Record" from the dropdown menu in the "Type" column. + 2. In Buttondown, copy everything before ".buttondown.xyz" from the "KEY" column. In Namecheap, paste it in the "Host" column. (Pink arrow on the left in screenshot below.) + 4. In Buttondown, copy everything from the "NEEDED" column. In Namecheap, paste it in the "Value" column. (Green arrow on the right in screenshot below.) + 5. Click the green checkmark. + + ![](/images/hosting-domains/hosting-on-Namecheap2.png) + +8. If it were tea, you’d wait for it to steep. But it’s computers, so Namecheap 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! + + +See Also: Sending from Namecheap if you want to send emails from a custom domain (like mail@newsletter.buttondown.xyz). + + +## 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, email me and I'm happy to help! \ No newline at end of file diff --git a/pages/getting-started/hosting-domains/hosting-on-nearlyfreespeech.mdx b/pages/getting-started/hosting-domains/hosting-on-nearlyfreespeech.mdx new file mode 100644 index 0000000..b5f9142 --- /dev/null +++ b/pages/getting-started/hosting-domains/hosting-on-nearlyfreespeech.mdx @@ -0,0 +1,82 @@ +--- +title: Hosting on a custom domain - NearlyFreeSpeech.NET +description: "A step-by-step guide: setting up a custom domain to host your newsletter with NearlyFreeSpeech.NET" +--- + +import Layout from "../../../components/Layout"; +import Notice from "../../../components/Notice"; + +export const meta = { + title: "Hosting on a custom domain - NearlyFreeSpeech.NET", + description: + "A step-by-step guide: setting up a custom domain to host your newsletter with NearlyFreeSpeech.NET", +}; +export default ({ children }) => {children}; + +# Hosting on a custom domain - NearlyFreeSpeech.NET + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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 NearlyFreeSpeech.NET account](https://members.nearlyfreespeech.net/login/?). Select the "domains" tab at the top of the screen (pink circle in screenshot below). Click the "Manage" button in the "DNS" column for the domain you want to send emails from (orange circle in screenshot below). + + ![](/images/hosting-domains/nearlyfreespeech-webpanel-navigation.png) + +6. Add the CNAME record - Take the information from the Buttondown popup and put it in NearlyFreeSpeech.NET: + + 1. Click “Add a DNS Resource Record” in the "Actions" box on the right. (Pink box in screenshot below.) + + ![](/images/hosting-domains/nearlyfreespeech-add-record.png) + + 2. In Buttondown, copy everything before ".buttondown.xyz" from the "KEY" column. In NearlyFreeSpeech.NET, paste it in the "Name" field. (Pink arrow on the left in screenshot below.) + 3. In NearlyFreeSpeech.NET, select "CNAME" from the "Type" dropdown menu. + 4. In Buttondown, copy everything from the "NEEDED" column. In NearlyFreeSpeech.NET, paste it in the "Data" field and add a dot (".") at the end of it. (Green arrow on the right in screenshot below.) + 5. Click “Add Resource Record”. + + ![](/images/hosting-domains/nearlyfreespeech-add-cname-record.png) + +8. If it were tea, you’d wait for it to steep. But it’s computers, so NearlyFreeSpeech.NET 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! + + +See Also: Sending from NearlyFreeSpeech.NET if you want to send emails from a custom domain (like mail@newsletter.buttondown.xyz). + + +## Troubleshooting + +### Did you remember to add a dot (".") at the end of the "Data" field for CNAME records? + +NearlyFreeSpeech.NET requires a dot (".") at the end of any CNAME Data that points to a domain other than your own. When you copy and paste something from Buttondown's "NEEDED" column like: +``` +lquhjw4i2i5ucs72wfo72hamq34c72im.dkim.amazonses.com +``` +you have to **add the dot at the end** in NearlyFreeSpeech.Net's "Data field", so it looks like: + +lquhjw4i2i5ucs72wfo72hamq34c72im.dkim.amazonses.com. + +![](/images/hosting-domains/nearlyfreespeech-troubleshooting-cname-dot.png) + +### 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, email me and I'm happy to help! diff --git a/pages/getting-started/hosting-domains/hosting-on-porkbun.mdx b/pages/getting-started/hosting-domains/hosting-on-porkbun.mdx new file mode 100644 index 0000000..566e2d5 --- /dev/null +++ b/pages/getting-started/hosting-domains/hosting-on-porkbun.mdx @@ -0,0 +1,64 @@ +--- +title: Hosting on a custom domain - Porkbun +description: "A step-by-step guide: setting up a custom domain to host your newsletter with Porkbun" +--- + +import Layout from "../../../components/Layout"; +import Notice from "../../../components/Notice"; + +export const meta = { + title: "Hosting on a custom domain - Porkbun", + description: + "A step-by-step guide: setting up a custom domain to host your newsletter with Porkbun", +}; +export default ({ children }) => {children}; + +# Hosting on a custom domain - Porkbun + + +Hosting on a custom domain?! What is this? Why is it important? This guide will explain everything. + + +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 Porkbun account](https://porkbun.com/account/login). Click the "Details" button to the right of the domain you want to send emails from (pink circle in screenshot below). Click the "Edit" link in the "DNS RECORDS" section (green circle in screenshot below). + ![](/images/sending-domains/porkbun-webpanel-navigation.png) +6. Add the CNAME record - Follow the steps below for the record that has “CNAME” in the “TYPE” column: + + 1. In Porkbun, select "CNAME - Canonical name record" from the "Type" dropdown menu. + 2. In Buttondown, copy everything before ".buttondown.xyz" from the "KEY" column. In Porkbun, paste it in the "Host" field. (Pink arrow on the left in screenshot below.) + 3. In Buttondown, copy everything from the "NEEDED" column. In Porkbun, paste it in the "Answer" field. (Green arrow on the right in screenshot below.) + 4. Click “Add”. + + ![](/images/hosting-domains/porkbun-add-cname-record.png) + +7. If it were tea, you’d wait for it to steep. But it’s computers, so Porkbun can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea. + +8. 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! + + +See Also: Sending from Porkbun if you want to send emails from a custom domain (like mail@newsletter.buttondown.xyz). + + +## 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, email me and I'm happy to help! diff --git a/public/images/hosting-domains/dnsimple-add-cname-record.png b/public/images/hosting-domains/dnsimple-add-cname-record.png new file mode 100644 index 0000000..05bc337 Binary files /dev/null and b/public/images/hosting-domains/dnsimple-add-cname-record.png differ diff --git a/public/images/hosting-domains/dreamhost-add-cname-record.png b/public/images/hosting-domains/dreamhost-add-cname-record.png new file mode 100644 index 0000000..23db79f Binary files /dev/null and b/public/images/hosting-domains/dreamhost-add-cname-record.png differ diff --git a/public/images/hosting-domains/godaddy-add-cname-record.png b/public/images/hosting-domains/godaddy-add-cname-record.png new file mode 100644 index 0000000..07e727b Binary files /dev/null and b/public/images/hosting-domains/godaddy-add-cname-record.png differ diff --git a/public/images/hosting-domains/godaddy-add-record.png b/public/images/hosting-domains/godaddy-add-record.png new file mode 100644 index 0000000..b34cd04 Binary files /dev/null and b/public/images/hosting-domains/godaddy-add-record.png differ diff --git a/public/images/hosting-domains/godaddy-webpanel-navigation.png b/public/images/hosting-domains/godaddy-webpanel-navigation.png new file mode 100644 index 0000000..0600e69 Binary files /dev/null and b/public/images/hosting-domains/godaddy-webpanel-navigation.png differ diff --git a/public/images/hosting-domains/hosting-domain.png b/public/images/hosting-domains/hosting-domain.png new file mode 100644 index 0000000..5ddc2c9 Binary files /dev/null and b/public/images/hosting-domains/hosting-domain.png differ diff --git a/public/images/hosting-domains/hosting-domain2.png b/public/images/hosting-domains/hosting-domain2.png new file mode 100644 index 0000000..7c867ea Binary files /dev/null and b/public/images/hosting-domains/hosting-domain2.png differ diff --git a/public/images/hosting-domains/hosting-domain3.png b/public/images/hosting-domains/hosting-domain3.png new file mode 100644 index 0000000..512a1d4 Binary files /dev/null and b/public/images/hosting-domains/hosting-domain3.png differ diff --git a/public/images/hosting-domains/hosting-on-Namecheap2.png b/public/images/hosting-domains/hosting-on-Namecheap2.png new file mode 100644 index 0000000..e525aa2 Binary files /dev/null and b/public/images/hosting-domains/hosting-on-Namecheap2.png differ diff --git a/public/images/hosting-domains/hosting-on-google-domains2.png b/public/images/hosting-domains/hosting-on-google-domains2.png new file mode 100644 index 0000000..0949753 Binary files /dev/null and b/public/images/hosting-domains/hosting-on-google-domains2.png differ diff --git a/public/images/hosting-domains/hosting-on-hover.png b/public/images/hosting-domains/hosting-on-hover.png new file mode 100644 index 0000000..a9556df Binary files /dev/null and b/public/images/hosting-domains/hosting-on-hover.png differ diff --git a/public/images/hosting-domains/hosting-on-hover2.png b/public/images/hosting-domains/hosting-on-hover2.png new file mode 100644 index 0000000..531a230 Binary files /dev/null and b/public/images/hosting-domains/hosting-on-hover2.png differ diff --git a/public/images/hosting-domains/namecheap-webpanel-navigation2.png b/public/images/hosting-domains/namecheap-webpanel-navigation2.png new file mode 100644 index 0000000..ce10c71 Binary files /dev/null and b/public/images/hosting-domains/namecheap-webpanel-navigation2.png differ diff --git a/public/images/hosting-domains/nearlyfreespeech-add-cname-record.png b/public/images/hosting-domains/nearlyfreespeech-add-cname-record.png new file mode 100644 index 0000000..6eb9599 Binary files /dev/null and b/public/images/hosting-domains/nearlyfreespeech-add-cname-record.png differ diff --git a/public/images/hosting-domains/nearlyfreespeech-add-record.png b/public/images/hosting-domains/nearlyfreespeech-add-record.png new file mode 100644 index 0000000..7bd565a Binary files /dev/null and b/public/images/hosting-domains/nearlyfreespeech-add-record.png differ diff --git a/public/images/hosting-domains/nearlyfreespeech-troubleshooting-cname-dot.png b/public/images/hosting-domains/nearlyfreespeech-troubleshooting-cname-dot.png new file mode 100644 index 0000000..f55c649 Binary files /dev/null and b/public/images/hosting-domains/nearlyfreespeech-troubleshooting-cname-dot.png differ diff --git a/public/images/hosting-domains/nearlyfreespeech-webpanel-navigation.png b/public/images/hosting-domains/nearlyfreespeech-webpanel-navigation.png new file mode 100644 index 0000000..5a64522 Binary files /dev/null and b/public/images/hosting-domains/nearlyfreespeech-webpanel-navigation.png differ diff --git a/public/images/hosting-domains/porkbun-add-cname-record.png b/public/images/hosting-domains/porkbun-add-cname-record.png new file mode 100644 index 0000000..9eab677 Binary files /dev/null and b/public/images/hosting-domains/porkbun-add-cname-record.png differ diff --git a/public/images/hosting-domains/red-alert.png b/public/images/hosting-domains/red-alert.png new file mode 100644 index 0000000..3f35420 Binary files /dev/null and b/public/images/hosting-domains/red-alert.png differ diff --git a/public/search-results.json b/public/search-results.json index 5062872..9ab3f0b 100644 --- a/public/search-results.json +++ b/public/search-results.json @@ -167,6 +167,42 @@ "title": "Building your subscriber base", "description": "Tips and resources for growing your subscribers and imbuing them with data" }, + { + "path": "/getting-started/hosting-domains/hosting-on-dnsimple", + "text": "Hosting on a custom domain - DNSimple Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In a new tab, log into your DNSimple account. From the menu on the left, click on the name of the domain you want to send emails from. Select \"DNS\" from the menu on the left (orange circle in screenshot below). In the DNS records section, click \"Manage\"(green circle on the right in screenshot below). Click on the \"ADD A RECORD\" button. (Red circle on the left in screenshot above.) Add the CNAME record - Take the information from the Buttondown popup and put it into DNSimple: Click the blue \"Add Record\" button. Choose \"CNAME\" from the drop-down menu. 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.) In Buttondown, copy everything from the \"NEEDED\" column. In DNSimple, paste it in the \"Content\" field. (Green arrow on the right in screenshot below.) 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. Once your DNS records have finished propagating, click “Check records” in Buttondown. If it gives you a green checkmark, you’re good to go! 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, email me and I'm happy to help! ", + "title": "Hosting on a custom domain - DNSimple", + "description": "A step-by-step guide: setting up a custom domain to host your newsletter with DNSimple" + }, + { + "path": "/getting-started/hosting-domains/hosting-on-dreamhost", + "text": "Hosting on a custom domain - DreamHost Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In another tab, go to your DreamHost Control Panel . 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. Add the CNAME record - Take the information from the Buttondown popup and put it in DreamHost: Click “Add Record” Click the “CNAME” box. 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.) 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.) Click “Add Record”. 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. Once your DNS records have finished propagating, click “Check records” in your Buttondown tab. If it gives you a green checkmark, you’re good to go! 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, email me and I'm happy to help! ", + "title": "Hosting on a custom domain - DreamHost", + "description": "A step-by-step guide: setting up a custom domain to host your newsletter with DreamHost" + }, + { + "path": "/getting-started/hosting-domains/hosting-on-google-domains", + "text": "Hosting on a custom domain - Google Domains Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In another tab, go to your Google Domains Control Panel . If you have more than one Google domain, use the domain name you want to send Buttondown emails from. From the menu on the left, click “DNS”. Take the information from the Buttondown popup and put it in Google Domains: 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.) Choose CNAME from the dropdown \"Type\" menu. 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.) 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. Once your DNS records have finished propagating, click “Check records” in Buttondown. If it gives you a green checkmark, you’re good to go! 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, email me and I'm happy to help! ", + "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" + }, + { + "path": "/getting-started/hosting-domains/hosting-on-hover", + "text": "Hosting on a custom domain - Hover Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In a new tab, log into your Hover account. Click on the DNS tab. (Orange circle on the right in screenshot below.)\n Click on the \"ADD A RECORD\" button. (Red circle on the left in screenshot above.) Take the information from the Buttondown popup and put it in Hover: Select “CNAME” from the \"type\" dropdown menu. (Green arrow on the left in screenshot below.) Enter the \"KEY\"\" from Buttondown where Hover asks for “HOSTNAME”. (Red arrow in the middle in screenshot below.) Enter the “NEEDED” from Buttondown where Hover asks for “TARGET NAME”. (Blue arrow on the right in screenshot below.) Click \"ADD RECORD\". 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. Once your DNS records have finished propagating, click “Check records” in Buttondown. If it gives you a green checkmark, you’re good to go! 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, email me and I'm happy to help! ", + "title": "Hosting on a custom domain - Hover", + "description": "A step-by-step guide: setting up a custom domain to host your newsletter with Hover" + }, + { + "path": "/getting-started/hosting-domains/hosting-on-namecheap", + "text": "Hosting on a custom domain - Namecheap Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In another tab, go to your Namecheap Domains List . Click the \"Manage\" button next to the domain you want to send emails from (pink circle in screenshot below). Add the CNAME record: “ADD NEW RECORD” at the bottom of the list. (Green circle in screenshot below.) In Namecheap, select \"CNAME Record\" from the dropdown menu in the \"Type\" column. In Buttondown, copy everything before \".buttondown.xyz\" from the \"KEY\" column. In Namecheap, paste it in the \"Host\" column. (Pink arrow on the left in screenshot below.) In Buttondown, copy everything from the \"NEEDED\" column. In Namecheap, paste it in the \"Value\" column. (Green arrow on the right in screenshot below.) Click the green checkmark. If it were tea, you’d wait for it to steep. But it’s computers, so Namecheap can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea. Click “Check records” in Buttondown. If it gives you a green checkmark, it means your DNS records have finished propagating. You’re good to go! 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, email me and I'm happy to help! ", + "title": "Hosting on a custom domain - Namecheap", + "description": "A step-by-step guide: setting up a custom domain to host your newsletter with Namecheap" + }, + { + "path": "/getting-started/hosting-domains/hosting-on-porkbun", + "text": "Hosting on a custom domain - Porkbun Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Enter your custom hosting domain. Scroll to the bottom of the page and click on the blue \"Update settings\" bar. Scroll back up to where you entered your custom hosting domain. Look for the red alert. Click on the \"Click here\" link. \n In another tab, log in to your Porkbun account . Click the \"Details\" button to the right of the domain you want to send emails from (pink circle in screenshot below). Click the \"Edit\" link in the \"DNS RECORDS\" section (green circle in screenshot below).\n Add the CNAME record - Follow the steps below for the record that has “CNAME” in the “TYPE” column: In Porkbun, select \"CNAME - Canonical name record\" from the \"Type\" dropdown menu. In Buttondown, copy everything before \".buttondown.xyz\" from the \"KEY\" column. In Porkbun, paste it in the \"Host\" field. (Pink arrow on the left in screenshot below.) In Buttondown, copy everything from the \"NEEDED\" column. In Porkbun, paste it in the \"Answer\" field. (Green arrow on the right in screenshot below.) Click “Add”. If it were tea, you’d wait for it to steep. But it’s computers, so Porkbun can take up to 24 hours to process your update. This is a good opportunity to enjoy some tea. Once your DNS records have finished propagating, click “Check records” in Buttondown. If it gives you a green checkmark, you’re good to go! 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, email me and I'm happy to help! ", + "title": "Hosting on a custom domain - Porkbun", + "description": "A step-by-step guide: setting up a custom domain to host your newsletter with Porkbun" + }, { "path": "/getting-started/hosting-on-a-custom-domain", "text": "Hosting on a custom domain There's no security, performance, or product-level benefit from hosting your newsletter on a custom domain. But,\nI think we all have to admit it — it's a little bit cooler. is simply a cooler and perhaps\neven more impressive domain than or . And there's nothing wrong with that! if you want to establish your newsletter as an independent entity, not simply a \"Buttondown newsletter\",\nsetting up a custom domain on which to host it makes a lot of sense. Setting up your custom hosting domain If you're not signed up for Buttondown for Professionals , go ahead and upgrade your account ! Add the custom domain in your settings page . Change the record of the domain you'd like to use as your custom domain to . The prompt should walk you through the rest of the process? Using a subdomain of This isn't possible to do in the UI, but there are no technical limitations. Email me and I'll get it wired up for you! The difference between hosting domains and sending domains Hosting on a custom domain means using a domain outside of to host your newsletter and archives — for example, newsletter.jmduke.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 sign up for Buttondown for Professionals ; sending does not. This is because, well, sending emails that actually get delivered is pretty dang important, and it's scummy to hide that behind a paywall. Can I use the same domain for hosting and sending? Unfortunately, some DNS providers will not let you set up the exact same domain or subdomain for both sending emails and as your custom archive. For these DNSes, we recommend setting up completely separate subdomains — something along the lines of the following: for your custom newsletter domain (where folks view archives and subscribe to your newsletter) for your custom sending domain (where outgoing emails come from) This is the best option to preserve the deliverability of your newsletter (and, frankly, most people are not particularly confused by this at all.) ", @@ -191,12 +227,6 @@ "title": "Scheduling an email", "description": "A step-by-step guide through sending your email at a later date" }, - { - "path": "/getting-started/sending-domains/sending-from-dreamhost", - "text": "Sending from a Custom Domain - DreamHost Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Your Email address must match your custom sending domain. (If your sending domain is buttondown.xyz, your email has to be name@buttondown.xyz ; name@gmail.com won’t work.) Change it if needed. Enter your custom sending domain Click “Click here” to get the correct DNS records. In another tab, go to your DreamHost Control Panel. From the menu on the left, select “Domains” > “Manage Domains”. Click “DNS” under the domain name you are setting up with Buttondown. Add the TXT record(s) - Follow the steps below for each record that has “TXT” in the “TYPE” column: Click “Add Record” Click the “TXT” box. For the “Host” in DreamHost, enter everything before “.buttondown.xyz” from the Buttondown “KEY”. (Pink arrow on the left in screenshot below.) Enter the “NEEDED” from Buttondown where DreamHost asks for “TXT Value”. (Green arrow on the right in screenshot below.) Click “Add Record”. Add the CNAME records - Follow the steps below for each record that has “CNAME” in the “TYPE” column: Click “Add Record” Click the “CNAME” box. For the “Host” in DreamHost, enter everything before “.buttondown.xyz” from the Buttondown “KEY”. (Pink arrow on the left in screenshot below.) Enter the “NEEDED” from Buttondown where DreamHost asks for “Points to”. (Green arrow on the right in screenshot below.) Click “Add Record”. If it were a pie, you’d wait for it to bake. But it’s computers, so DreamHost will take some time to process your update. This is a good opportunity to go bake a pie. Once your DNS records have finished propagating, click “Check records” in Buttondown. If they all come up with green checkmarks, you’re good to go! Troubleshooting Did you enter the DNS “KEY” (aka “Host” or “Name”) correctly? Some registrars want the entire “KEY”, but DreamHost only wants the part before “.buttondown.xyz”. If the “Host”/”Name” field for any of your DNS records in DreamHost ends with “.buttondown.xyz”, remove that part. Are your DNS records still propagating? I know setting up DNS records is a pain! If it's been a few hours and you're still not seeing the records get validated in the way you expect, email me and I'm happy to help! See Also Hosting on a Custom Domain - DreamHost ", - "title": "Sending from a custom domain - DreamHost", - "description": "A step-by-step guide through setting up a custom domain to send your newsletter with DreamHost" - }, { "path": "/getting-started/sending-from-a-custom-domain", "text": "Sending from a custom domain Unlike hosting on a custom domain which is largely a cosmetic\nfeature, 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 — it means when you are first\nstarting your newsletter you can focus on writing, editing, and growing instead of dealing with arcane DNS issues. However, as your newsletter matures it becomes a better idea to think about sending directly from your domain instead. This has a number of benefits: Your emails look more professional. Open and click rates are non-trivially improved for newsletters that are coming from, say, instead of . You can start accruing \"domain reputation\" for your own domain. This improves the overall engagement rate for your emails. More importantly, that domain reputation carries with you — even if you leave Buttondown for another service, so long as that service also allows you to send from a custom domain. Dealing with emails that are ending up in spam If you're not using a custom sending domain, then this is likely because you're sending your email from Buttondown's mail servers, but 'signing' it with your own email address. This looks like spam (or at least mistaken identity) to most mailboxes, especially if you're sending from a or account. To remediate this, you should send your emails directly from Buttondown: This will cause emails to come from your-username@mg.buttondown.email , which will have very high deliverability: Dealing with 'softfails' due to SPF Depending on your newsletter configuration, you might have been asked to set up an SPF entry for your custom domain. This is a DNS record that begins with the string: However, this record can only be used 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\nto combine the two records. Instead of having two separate records, like: and The proper solution is actually to edit the existing one into something like that references both domains: Otherwise, some mailboxes may read the GSuite one and ignore the Mailgun one (set by Buttondown), causing a softfail and thus lower deliverability. The difference between hosting domains and sending domains Hosting on a custom domain means using a domain outside of to host your newsletter and archives — for example, newsletter.jmduke.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 sign up for Buttondown for Professionals ; sending does not. This is because, well, sending emails that actually get delivered is pretty dang important, and it's scummy to hide that behind a paywall. Can I use the same domain for hosting and sending? Unfortunately, some DNS providers will not let you set up the exact same domain or subdomain for both sending emails and as your custom archive. For these DNSes, we recommend setting up completely separate subdomains — something along the lines of the following: for your custom newsletter domain (where folks view archives and subscribe to your newsletter) for your custom sending domain (where outgoing emails come from) This is the best option to preserve the deliverability of your newsletter (and, frankly, most people are not particularly confused by this at all.) ", @@ -253,7 +283,7 @@ }, { "path": "/migration-guides/convertkit", - "text": "ConvertKit Importing your subscribers Export your ConvertKit subscribers here . Go to https://buttondown.email/settings . You may need to log in first. Scroll to the bottom of the page. Click the Import subscribers button at the bottom of the page, then choose the csv file you just downloaded from AWeber Importing your archives (broadcasts) To quote ConvertKit in November 2021, “ Apologies, at this time, we do not have an option on our app to export broadcast emails. ” “ You have to manually copy and paste ” ConvertKit said they have added this as a feature request. You could also try reaching out to them and see if they will export your broadcast emails for you. Once they give you access to your data, email me and I’ll help you with importing your archives. You did it! Once you finish the above steps, Buttondown will kick off an audit and migration process to make sure everything is in order. Then you should be safe to disable or deactivate your ConvertKit account. Do subscribers need to re-enter their credit card? ConvertKit and Buttondown use the same payments processor - Stripe . Stripe has your subscribers' information: credit cards purchases subscriptions You bring your subscribers' history to Buttondown when you connect your Stripe account to Buttondown. You will have their payment histories, too. Your paying subscribers do not need to do anything extra when you switch to Buttondown . Just email me when you've connected your Stripe account. I'll take care of the rest, for free! P.S. Over time, I'd like to make this process a little more automatic but at the moment it requires a bit of manual labor on my part to make sure everything is wired up correctly (free of charge, of course.) By the way With Buttondown, it’s easy to export all your data : ", + "text": "ConvertKit Importing your subscribers Export your ConvertKit subscribers here . Go to https://buttondown.email/settings . You may need to log in first. Scroll to the bottom of the page. Click the Import subscribers button at the bottom of the page, then choose the csv file you just downloaded from ConvertKit. Importing your archives (broadcasts) To quote ConvertKit in November 2021, “ Apologies, at this time, we do not have an option on our app to export broadcast emails. ” “ You have to manually copy and paste ” ConvertKit said they have added this as a feature request. You could also try reaching out to them and see if they will export your broadcast emails for you. Once they give you access to your data, email me and I’ll help you with importing your archives. You did it! Once you finish the above steps, Buttondown will kick off an audit and migration process to make sure everything is in order. Then you should be safe to disable or deactivate your ConvertKit account. Do subscribers need to re-enter their credit card? ConvertKit and Buttondown use the same payments processor - Stripe . Stripe has your subscribers' information: credit cards purchases subscriptions You bring your subscribers' history to Buttondown when you connect your Stripe account to Buttondown. You will have their payment histories, too. Your paying subscribers do not need to do anything extra when you switch to Buttondown . Just email me when you've connected your Stripe account. I'll take care of the rest, for free! P.S. Over time, I'd like to make this process a little more automatic but at the moment it requires a bit of manual labor on my part to make sure everything is wired up correctly (free of charge, of course.) By the way With Buttondown, it’s easy to export all your data : ", "title": "ConvertKit", "description": "A step-by-step guide of migrating from ConvertKit to Buttondown" }, @@ -277,7 +307,7 @@ }, { "path": "/migration-guides/mailcoach", - "text": "Mailcoach Importing your subscribers Export your Mailcoach subscribers here . Go to https://buttondown.email/settings . You may need to log in first. Scroll to the bottom of the page. Click the Import subscribers button at the bottom of the page, then choose the csv file you just downloaded from AWeber Importing your archives (campaigns) According to Mailcoach (as of January 2022), \"there is no way to export [ campaigns] in the interface.\" You can, however, retrieve all of your campaigns via the API . Once you get your data, email me and I’ll help you with importing your archives. You did it! Once you finish all of the above steps, Buttondown will kick off an audit and migration process to make sure everything is in order. Then you should be safe to disable or deactivate your AWeber account. By the way With Buttondown, it’s easy to export all your data : ", + "text": "Mailcoach Importing your subscribers Export your Mailcoach subscribers here . Go to https://buttondown.email/settings . You may need to log in first. Scroll to the bottom of the page. Click the Import subscribers button at the bottom of the page, then choose the csv file you just downloaded from Mailcoach. Importing your archives (campaigns) According to Mailcoach (as of January 2022), \"there is no way to export [ campaigns] in the interface.\" You can, however, retrieve all of your campaigns via the API . Once you get your data, email me and I’ll help you with importing your archives. You did it! Once you finish all of the above steps, Buttondown will kick off an audit and migration process to make sure everything is in order. Then you should be safe to disable or deactivate your AWeber account. By the way With Buttondown, it’s easy to export all your data : ", "title": "Mailcoach", "description": "A step-by-step guide of migrating from Mailcoach to Buttondown" }, @@ -333,5 +363,11 @@ "text": "Privacy and security Why Buttondown requires Javascript on archive pages No interesting reason, just technical debt! This is something I hope to improve\nin the future. GDPR compliance Buttondown is of course fully GDPR compliant. You can read Buttondown's privacy policy here and its cookie policy here . If you're interested in a full data request, please email me . Bug bounty Sadly, Buttondown doesn't have the security budget to offer a bug bounty, but I would be deeply indebted to you for doing so! Please report any vulnerabilities to justin@buttondown.email — I promise to respond promptly and provide a fix as soon as humanly possible. Sincere kudos to the following individuals for reporting vulnerabilities: John Bullecer Vivek Modi Filippo Valsorda Iheanyi Ekechukwu Turning off link or click tracking Go to your account settings page and check the \"opt out of analytics\" checkbox!: Adult content policy My default stance is to support all content so long as it is not harassing, damaging, or otherwise illegal. However, paid newsletters are a bit of a different story. Buttondown uses Stripe to process payments; Stripe has some restrictions on adult content. Specifically, it prohibits: Pornography and other obscene materials (including literature, imagery and other media) depicting nudity or explicitly sexual acts; sites offering any sexually-related services such as prostitution, escorts, pay-per view, adult live chat features; sexually oriented items (e.g., adult toys); adult video stores and sexually oriented massage parlors; gentleman's clubs, topless bars, and strip clubs; sexually oriented dating services Unfortunately, that means things are out of my hands: if you want to send adult content over Buttondown you cannot use its paid subscriptions functionality. Financial assistance to writers No. In the event that I started such a practice, I would publish information about what heuristic I used as well as a full list of writers receiving such assistance. But I will almost certainly never do this. It is a violation of Buttondown's core ethos, which is that Buttondown is a tool rather than an ecosystem — a piece of software, rather than a platform. It's important to me that people using Buttondown are, at the end of the day, writing newsletters , not Buttondowns . WCAG compliance Buttondown follows the compliance checklist as outlined by HHS . If you have any other specific questions regarding Buttondown's accessibility, I'd be happy to answer — and if there are any specific accessibility gaps that you identify\nin Buttondown, please let me know! I'd be happy to prioritize a fix. ", "title": "Privacy & security", "description": "Various privacy and security aspects important to Buttondown (and its users)" + }, + { + "path": "/sending-domains/sending-from-dreamhost", + "text": "Sending from a custom domain - DreamHost Log in to your Buttondown account. Click on the menu in the top right corner and select “Your newsletter”. Your Email address must match your custom sending domain. (If your sending domain is buttondown.xyz, your email has to be name@buttondown.xyz ; name@gmail.com won’t work.) Change it if needed. Enter your custom sending domain. Click “Click here” to get the correct DNS records. In another tab, go to your DreamHost Control Panel. From the menu on the left, select “Domains” > “Manage Domains”. Click “DNS” under the domain name you are setting up with Buttondown. Add the TXT record(s) - Follow the steps below for each record that has “TXT” in the “TYPE” column: Click “Add Record” Click the “TXT” box. For the “Host” in DreamHost, enter everything before “.buttondown.xyz” from the Buttondown “KEY”. (Pink arrow on the left in screenshot below.) Enter the “NEEDED” from Buttondown where DreamHost asks for “TXT Value”. (Green arrow on the right in screenshot below.) Click “Add Record”. Add the CNAME records - Follow the steps below for each record that has “CNAME” in the “TYPE” column: Click “Add Record” Click the “CNAME” box. For the “Host” in DreamHost, enter everything before “.buttondown.xyz” from the Buttondown “KEY”. (Pink arrow on the left in screenshot below.) Enter the “NEEDED” from Buttondown where DreamHost asks for “Points to”. (Green arrow on the right in screenshot below.) Click “Add Record”. If it were a pie, you’d wait for it to bake. But it’s computers, so DreamHost can take up to 24 hours to process your update. This is a good opportunity to go bake a pie. Once your DNS records have finished propagating, click “Check records” in Buttondown. If they all come up with green checkmarks, you’re good to go! Troubleshooting Did you enter the DNS “KEY” (aka “Host” or “Name”) correctly? Some registrars want the entire “KEY”, but DreamHost only wants the part before “.buttondown.xyz”. If the “Host”/”Name” field for any of your DNS records in DreamHost ends with “.buttondown.xyz”, remove that part. 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, email me and I'm happy to help! ", + "title": "Sending from a custom domain - DreamHost", + "description": "A step-by-step guide through setting up a custom domain to send your newsletter with DreamHost" } ] \ No newline at end of file