Knowledge Base — Domains

Path: Centers → Products → Knowledge Base → Domains · URL: /knowledge-base?tab=domains

What this page does

The Knowledge Base product gives you a public-facing portal where customers, partners, or internal teammates can read your articles. The Domains tab is where you control the URL that portal lives at.

Two types of domains:

• Assigned domain — always on, automatically provisioned. Format: <org-slug>-kb.wazzi.io. You can't remove it, but you can use it as a fallback or for internal-only portals.
• Custom domain — optional. Use your own subdomain like help.yourcompany.com for a fully white-labeled experience.

When to use which

Situation	Which domain
Internal-only KB	Assigned domain is fine — your team can bookmark <slug>-kb.wazzi.io.
Public help center for your customers	Custom domain. Looks more professional and is on-brand.
Both internal and external portals	Both. The same KB can serve <slug>-kb.wazzi.io for staff and help.yourcompany.com for customers, with different portals visible at each.

Steps

1. Open the KB page → Domains tab.

2. Use the assigned domain to preview your portal.

• Click the open-in-new icon to see the live portal at <org-slug>-kb.wazzi.io.
• Click the refresh icon to re-check the SSL / provisioning status.

3. (Optional) Add a custom domain.

Type your subdomain (e.g., help.yourcompany.com) into the Custom domain input and click the save icon. You'll see a Not configured status until you complete the DNS step.

4. Add the DNS record.

Log into your DNS provider (Cloudflare, Route53, Google Domains, etc.) and add a CNAME record:

Name:    help (or whatever subdomain you chose)
Type:    CNAME
Value:   cname.wazzi.io  (the exact value is shown on the Domains tab)
TTL:     Auto / 300

Apex domains. If you want yourcompany.com (no subdomain) pointing at your KB, your DNS provider needs to support CNAME flattening or ALIAS records. Cloudflare and Route53 do; some older providers don't. The simplest workaround is to use a subdomain like kb.yourcompany.com.

Once your DNS provider serves the new record, click the refresh icon on the Domains tab — the status will move to Verifying, then Active once the SSL certificate is issued. SSL provisioning typically takes 30 seconds to 5 minutes.

Troubleshooting

• "Not configured" won't go away after I add the CNAME. DNS propagation can take up to a few hours globally, but most providers update within minutes. Check using dig help.yourcompany.com CNAME from your terminal — if the answer matches cname.wazzi.io, the record is live and Wazzi just needs to re-check (click refresh).
• CAA record is blocking SSL issuance. If you have a CAA record on your apex domain that doesn't include Let's Encrypt, the certificate can't be issued. Add 0 issue "letsencrypt.org" to your CAA records.
• Status flips between Verifying and Error. Usually means DNS is misconfigured intermittently (e.g., one of two CNAME values is wrong). Verify with dig from a few different DNS resolvers.
• I want to switch domains. Add the new one, wait for it to go Active, then remove the old one. Avoid removing the old one first — your KB will be unreachable until the new one provisions.

Best practices

• Use a subdomain like help. or kb. rather than your apex. Easier DNS, more flexibility.
• Test in a private window after going Active. Browser caches sometimes serve stale TLS certs.
• Set up monitoring on your KB domain. A simple uptime monitor (UptimeRobot, Pingdom) catches DNS / SSL drift before customers complain.

Frequently asked questions

Can I use multiple custom domains on one KB?
Yes — Wazzi supports multiple custom domains per KB. Useful for multi-brand setups.

Will SSL auto-renew?
Yes. Wazzi handles certificate renewal automatically via Let's Encrypt.

What happens if I remove the custom domain?
The portal becomes unreachable at that URL immediately. Visitors get a 404 until you re-add a record.

What's next

• Brand the portal: Knowledge Base — Theme.
• Decide who can see what: Knowledge Base — Portals.