As standard, Turtl provides you with your own domain for all of the content you create with us. These will always end in turtl.co (for example, mycompany.turtl.co) and are a great way to feature your company name in all of your Turtl links.
However, it is possible to configure Turtl to use a different domain (for example, content.mycompany.com) so that no reference to Turtl is visible in your links.
This provides an additional level of branding for you and, while it won’t ensure that all PageRank benefits arising from your Turtl Docs are fully attributed to your company domain name, it will aid in creating a link between your Turtl Docs and website content.
Note: If you'd like to set up a custom domain, we advise you to forward this support article to the person or department in your company responsible for DNS or network management.
How to set up CNAME delegation
1. Choose your subdomain
Choose your domain name. You'll need to have a conversation internally about the name you want to use, but it will need to be a subdomain of your existing website. For example, you could have content.mycompany.com, stories.mycompany.com or learn.mycompany.com.
2. Contact your IT team
Identify the person or department in your company responsible for DNS or network management. They will need to verify the availability of your chosen subdomain and confirm they can create CNAME records. Send your IT team or person a link to this support article and ask them to continue the process.
3. Set Up the CNAME record
First, you'll need to create a CNAME record pointing to d.sni.global.fastly.net for your chosen subdomain.
Identify whether you are using Fastly to serve your website (the one whose subdomain you'd like as your new Turtl domain name).
a. You are not a Fastly customer
Good news. We can take care of everything on our end. Unless you have internal policies requiring you to use your own provider for TLS certificates, please refer to step 4.
b. You are a Fastly customer
If you are a Fastly customer, it's likely, that we won't be able to add your chosen domain name to our service because Fastly will recognize it as already belonging to you. In this case, you have two options:
Contact Fastly and have the chosen subdomain delegated to our service. Tell us you've chosen this way and we'll send you the details.
Let us contact Fastly and we'll provide you with a
TXT DNSrecord, which you'll have to add to your other DNS records on your apex domain. Then we'll complete the process on our side.
4. Custom TLS certificates
Note: This step is only required if you have internal policies requiring you to use your own provider for TLS certificates.
If that is the case, please notify us and we'll generate a CSR (certificate signing request) for you. Please provide all the information you'd like to have included in the certificate when making the request. After you sign the CSR, please forward the resulting certificate file to support@turtl.co and we'll use it to secure your chosen domain name.
How long does it take us to set up a CNAME?
You can expect to hear from us within 24 hours. If we have everything we need from you, your CNAME will have been set up by then.
The processing time is longer if:
You are a Fastly customer.
You require a custom TLS certificate.
Some information is missing.
Access via CNAME
Once we complete the process on our side, you'll be able to access Turtl and all your content via your custom domain, such as https://content.mycompany.com/story/mydoc