Set up a custom domain using a CNAME

When you install Docs, you'll be asked to fill in a subdomain, which is used to access your public-facing knowledge base. You can share this subdomain with your customers, or you can set up a custom domain, such as This article walks you through setting up a custom domain.

In this article

Adding a custom domain

We're going to use as our Docs domain. Our subdomain is Just add your desired custom domain to the Custom Domain field on the Docs Settings page. Make sure that Public Docs Website switch is ON, then click the blue Save button at the bottom of the page.

Creating a CNAME

To make all of this jive, you'll need to create a CNAME with your DNS provider. In most cases, your DNS provider is where you registered your domain name. For example, Hover or GoDaddy. When you create the CNAME, you'll be prompted to insert a host name or subdomain. Continuing with our example above, help would be our subdomain.

You'll also be asked to add a destination URL for your custom domain. In this case, it would be In other words, we're simply setting up a rule that says:

  • If a customer visits (our custom domain), they should see the page located at (our Docs subdomain).
  • If a customer visits (your custom domain), they should see the page located at (your Docs subdomain).

Note: Once you save the CNAME, it can take up to 24 hours for it to propagate and properly point to Help Scout. Although, you could see changes take effect in as little as an hour. If you see any TTL settings when setting up your CNAME, just leave those as is.

Still stuck? How can we help? How can we help?