Ask AI

Connecting a custom domain

Learn how to connect your own custom domain

HelpKit allows you to setup a custom domain for your site. This way your users can find your site by typing something like support.example.com instead of the default example.helpkit.so

1. Find your domain's DNS record settings

Navigate to your domain registrar. This is where you bought your domain name. NameCheap, GoDaddy, Cloudflare or Google Domains are a few common ones.

You should see some settings for your domain called something like DNS.

 

In this example I will be using NameCheap and navigate to the Advanced DNS section.

Notion image

You should see a settings table that has fields similiar to Type, Host, Value and TTL

Notion image

2. Add a new CNAME record

Next, create a new row in your domain registrar that has the Type of CNAME. In the Host field enter your preferred subdomain name such as support, docs or help. For the Value you should add your default HelpKit domain. You can safely ignore TTL (if you have to set a value you can freely choose one)

Notion image

3. Connect HelpKit to your custom domain

In the HelpKit dashboard navigate to Settings/General and scroll down to the Domains section:

Notion image

Then add your desired custom domain with the subdomain you have setup in step 2. Enter your pure domain name without things such as https:// or www.

Notion image

4. Verify your domain (Not always necessary)

In the best case you will see a green ✅ Verified button right after step 3. However, sometimes it can take a while for the service to verify your domain. In that case you will see the following screen:

Notion image

We suggest to wait a minute or two and then click the blue 🔁 Verify button. If you still see the same screen, please wait a bit more and try again. Ultimately you should see the following screen with a green ✅ Verified button:

Notion image

That's it ✨

 
After the successful setup, you might see your site being marked as "insecure" by the browser. No need to worry. Setting up your secure SSL certificate for your custom domain can take up to a couple of minutes. Please be patient, grab a coffee or tea and wait until it got propagated. Then refresh the page a couple of times and you should see a green secure symbol next to your browser's address bar 🔒
 

👍 Automatic Canonical

After you have connected your custom domain, HelpKit will automatically set your custom domain as canonical. This effectively tells search engines like Google what the 'preferred' or 'main' URL of a page should be and avoids multiple content issues.

 

Please reach out to dominik@helpkit.so if you need further help with the setup ✨

 
Did this answer your question?
😞
😐
🤩

Last updated on September 7, 2021