Custom Domain Troubleshooting

This article shows how to troubleshoot your custom domain or subdomain.

Check Domain Propagation Status

It can take between 24 and 48 hours for your new domain to fully start working—a period called domain propagation. During this period, your visitors may not be directed to your new domain right away. You can check the current status of your domain’s DNS propagation by visiting this DNS Propagation Checker tool. After domain propagation, you should be directed to your school when you visit your new domain. If it's been more than 72 hours, contact Customer Care.

Convert Your Internationalized Domain Name

If your domain contains language-specific script, such as Arabic or Chinese, you may encounter problems setting up your domain.

To avoid this issue, convert the domain to Punycode and set it as your primary domain. You can keep the original version and set it to redirect to the Punycode domain.

In the example below, the first domain name is in Punycode, while the second is the original internationalized version.

Add Custom Domain Inside Teachable

If you've set up your custom domain through your DNS provider, an error like this may occur when you attempt to visit your Teachable school:

404_Error_-_Teachable.png

If this happens, ensure that you’ve added your custom domain to your school in the Site > Domains section of your school admin. Click New Domain and add your domain name. Then, click Check Domain to verify your domain. If you’re still unable to verify the domain, check that the domain you’ve chosen with your provider matches the one you’ve entered into Teachable.

verified domain

Set Up a Redirect

If you have an old domain, such as a Teachable subdomain, you’ll need to redirect the old domain to your new one. You can set this up by using Cloudflare’s Page Rules, and by creating a CNAME record pointing to your Teachable subdomain. This process usually takes anywhere from 24-48 hours to fully process and verify.

Create a Separate Record

When adding your custom domain name in the Domains section of your school admin, check that you have not included www. or http://. If you want your website to contain www. before the domain, you need to create a separate CNAME record for that.

NOTE: For SEO purposes, it's better if you only use yourdomain.com instead of both www.yourdomain.com and yourdomain.com.

Configure DNS for Root Domains

Configuring your DNS provider for a root domain is usually the same as configuring it for a subdomain, but you may run into problems when using a CNAME record. This is because, although subdomains always use a CNAME, depending on your DNS provider, root domains do not always use a CNAME.

To solve this, figure out what your DNS provider uses (ALIAS/ANAME/CNAME) and always point that to the DNS target.

Flush DNS

Local DNS resolvers cache a domain name to IP mapping, so it may seem like your domain is not working. However, your computer may be pulling up an old, cached IP address, instead of searching for a new one and locating the correct record. Therefore, flushing DNS on your computer can resolve the issue. For more detailed instructions, refer to this guide.

DNS Provider Support Pages

For more specific information on troubleshooting your custom domain, check out your DNS provider's’ domain support pages:

Was this article helpful?
0 out of 0 found this helpful
thanks_illustration

Can't find what you're looking for?

Contact us
thanks_illustration