SapanBaseHelp Center

Serve knowledge bases on a domain (root KB + path-based KBs)

Knowledge Bases3 min read · Updated 2 months ago

A custom domain is not limited to a single knowledge base. You can serve several from the same domain, each at its own URL, and choose which one greets visitors at the root.

Root versus path-based knowledge bases

AssignmentURL
The root knowledge basehttps://yourdomain.com/
Every other assigned knowledge basehttps://yourdomain.com/its-slug

The rules that apply:

  • One domain per knowledge base. A knowledge base can be assigned to only one of your domains at a time. In the domain's checklist, a knowledge base already on another domain is greyed out with an Assigned to note naming that domain.
  • Public only. Custom domains serve public knowledge bases. Private ones are not offered, and a knowledge base that goes private is removed from its domain automatically.
  • One knowledge base means it is the root. The Serve at the domain root picker only appears once two or more knowledge bases are ticked. With a single one, it serves at the root without a choice to make.
  • No root is an option. With several assigned, you can pick No root, visitors land on the first assigned KB instead of naming one.

Assign from the Domains page

Company-wide assignment lives under Settings > Domains: open a domain's row, tick the knowledge bases under Assign knowledge bases, pick the root, and click Save changes. The full setup flow, including DNS verification, is in Set up a custom domain: add, DNS records, verify & remove.

Assign from a knowledge base's own settings

When you are already inside a knowledge base, you can assign it without leaving.

  1. Open the knowledge base's settings from the sidebar and choose Custom domain.
  2. Pick a domain from the Assign to domain dropdown, or leave it unassigned.
  3. Turn Serve at the domain root on to make this the root, or leave it off to serve at /its-slug on that domain.
  4. Click Save. Use Discard changes to back out.

If making this knowledge base the root would displace another one, the page tells you: This will replace "Other name" as the root of that domain.

This is the same assignment as the checklist on the Domains page, scoped to one knowledge base at a time.

If the knowledge base is private, this page says so and does not offer a domain. If your company has no domains yet, it shows No domains yet with an Add a domain button that takes you to Settings > Domains.