How can we help you?

Set Up A Custom Domain For Your Help Center

What this does

A custom domain lets your help center live at an address you own, such as help.yourcompany.com, instead of the default Velaro address. You can set it, read it back and check its status yourself, without contacting Velaro.

Before you start

  • Pick a subdomain you control, for example help.yourcompany.com. Use a subdomain, not your main website address.
  • Custom domains are part of the KB Custom Domain add-on. If your account does not have it yet, see your plan.
  • You need access to your domain's DNS settings.

Set your domain

  1. Open Knowledge Base, Settings.
  2. Enter your domain in the Domain field and save.
  3. Your domain shows the status Pending while it is being connected.

You can also set it from the command line or from an AI assistant connected to Velaro:

velaro kb settings set --domain help.yourcompany.com
velaro kb settings get

The get command shows your domain, its status and the public address your help center is using right now. To remove your custom domain, run velaro kb settings set --domain "". In an AI assistant, use the Knowledge Base settings tools with the same domain value.

Point your DNS at Velaro

At your DNS provider, add a CNAME record for your subdomain that points to the address shown on the Settings page. DNS changes can take from a few minutes to a few hours to be seen everywhere.

Read your status

  • Pending: your domain is saved and is being connected.
  • Active: your domain is live and serves your help center over a secure connection.

Until the status is Active, your help center keeps using its default Velaro address, so visitors are never sent to an address that is not ready.

Good to know

  • Each domain can belong to one help center.
  • Share the new address in your website footer, email signatures and support auto replies once it is Active.
Share: Email

Was this article helpful?