This article shows how to troubleshoot your custom domain. Setting up your custom domain can be a little tricky, but it’s not something you’ll have to do very often. If, after reading this article, you’re still having trouble setting up your Teachable domain, file a support ticket to get the help you need.
Understanding Domain Propagation
It can take between 24 and 48 hours for your new domain to fully start working, which is a period called domain propagation. This means that not all of your visitors will be directed to your new domain right away. If it's been more than 72 hours, file a support ticket with Teachable.
You can check the current status of DNS propagation after changing your domain by visiting this website.
Understanding Internationalized Domain Names
Some users with schools in other languages encounter problems setting up domain names with foreign-language-specific scripts (aka internationalized domain names).
To avoid this issue, simply convert the domain to Punycode and set that 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 setup your custom domain through your DNS provider, an error like this may occur when you attempt to visit your Teachable school:
If this happens, make sure you’ve added your custom domain inside Teachable. You can do this by going to Site > Domains in the Teachable admin area and typing in your custom domain. Once you’ve entered your custom domain name, it’s important to verify your domain by clicking Check Domain. If you’re still having no luck, be sure that the domain you’ve chosen in your provider is the same as the one you’ve entered into Teachable.
If you have an old domain, such as a Teachable subdomain (yoursite.teachable.com), make sure to redirect the old domain to your new one. You can easily set this up using Cloudflare’s Page Rules, and creating a CNAME record pointing to your school URL on Teachable. Learn more about this here. This process usually takes anywhere from 24-48 hours to fully process.
After 48 hours, check that your domain is verified by going to Site > Domains. Next to your custom domain, click Check Domain. If your domain is verified, click Make Primary.
NOTE: Do not set your new domain as "Primary" until you know the transfer is complete. If you set your new domain as the Primary too early, you will be unable to log into your school.
When adding your custom domain name in Teachable, check that you have not included www. or http://. If you want your website to have 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.
Configuring DNS for Root Domains
Configuring your DNS provider for a root domain is usually the same as configuring it for a subdomain (yoursite.teachable.com), but you may run into problems when using a CNAME record. This is because, although subdomains always use a CNAME, root domains do not always use a CNAME - it depends on your DNS provider.
To solve this, figure out what your DNS provider uses (ALIAS/ANAME/CNAME) and always point that to the DNS target. Find out more here.
If nothing else seems to be working, try flushing your DNS by following the steps outlined here.
DNS Provider Support Pages
For more specific information on troubleshooting your custom domain, check out your DNS provider's’ domain support pages: