Share:
ClickHelp Documentation

Custom Domain Name for Your Portal

In ClickHelp, you can change your default Domain Name to a custom name of your choice. 

The default name of any ClickHelp portal look something like this: yourportal.clickhelp.co. It is possible to assign a custom domain name to your portal. Typically, you may want the documentation portal to be a subdomain of your main company domain: docs.my-company-website.com. This is possible, you may just need some help from your IT department to make a change in the DNS records of your company domain.

Assign a Custom Domain Name

To change the Domain Name:

  • Go to Tools | Portal Settings
  • Click Administration > Domain Management in the left-hand navigation panel. The following settings page will open, where you can configure your custom Domain Name:

  • Choose Use custom domain name, and you will see the Domain Mapping section:
  • Ask your IT department to change the DNS records through your domain registrar's interface. The idea of the change is simple - you link your default portal name with your own custom domain name by creating a special CNAME record. You can see the instructions in the settings page under item #1 on the list of steps.
  • Type the new Domain Name in the box at step 2.
  • Click the Save Changes button to submit your Domain Name change request to us. We will verify the settings to make sure the new domain name resolves properly, and then apply the changes and send you a confirmation e-mail.
Warning The DNS records may take up to 24 hours to be applied on your domain registrar's side. The older records can be cached in your network making the update time even longer - you can reboot your Internet proxy or router device to make it update its DNS records.

Installing an SSL Certificate for a Custom Domain

Once you change the domain name of your portal, our own SSL certificate will not work for you anymore, since it covers only the *.clickhelp.co sub-domains. To make sure your authors work through a secure channel, we recommend installing your own SSL certificate for the custom domain name you applied for the documentation portal. Once you purchase your SSL certificate, follow the steps below to install it for your portal - this is done on the same Domain Management settings page.
  • Enable the Enable HTTPS checkbox. More HTTPS settings will be displayed on the page: 

  • Upload your SSL certificate at step 4 and specify the PFX file password in the corresponding box. 
  • At step 5 you can choose whether you want to force secure connections for everyone or for Authors and Power Readers only.
  • When you have everything configured, click the Save Changes button to submit the changes. We will verify the settings, and apply the changes within 24 hours.
After your request has been processed, your Online Documentation Portal will become available by the new custom Domain Name. This way, you will get a unique Domain Name that can match your main website name and increase your recognition on the web.