Custom Domain
Overview
Custom domains let you serve shared documents and your Knowledge Base under your own domain (e.g., docs.yourcompany.com) instead of the default clarife.app URL. This provides a branded experience where visitors never see the clarife domain.
ℹ️ Info: Custom domains are available on the Business plan only - you can add up to 3 domains, for example a separate one per product.
How to Set Up a Custom Domain
Step 1 - Go to Settings > Branding > Custom domains
In the clarife dashboard, navigate to Settings > Branding > Custom domains. Every domain you add gets its own card with the verification status, SSL certificate and home page settings.
Step 2 - Enter your domain
Type the subdomain you want to use (e.g., docs.yourcompany.com). A root domain like yourcompany.com is not supported - use a subdomain.
Step 3 - Add the CNAME record
In your DNS provider (Cloudflare, Route 53, GoDaddy, etc.), create a CNAME record:
| Type | Name | Target |
|---|---|---|
| CNAME | docs | custom.clarife.app |
Step 4 - Verify the domain
Click Verify in clarife. DNS propagation can take a few minutes to a few hours. Once verified, the status changes to Active.
Step 5 - Share documents on your domain
Your shared documents are now accessible at https://docs.yourcompany.com/s/abc123. Existing share links on clarife.app continue to work as well.
Domain Home Page
On the domain card you choose what its root address shows:
- clarife info page - a neutral default page.
- Redirect to URL - for example to your company website.
- Knowledge base - the domain becomes the address of your documentation: the base home page sits directly on the domain and entries live at short addresses like
docs.yourcompany.com/entry-name. See Appearance and domain for details.
SSL Certificate
clarife automatically provisions an SSL certificate for your custom domain after verification. No manual certificate setup is needed. HTTPS is enforced by default.
DNS Propagation
After adding the CNAME record, DNS changes may take up to 24-48 hours to propagate globally, though most providers update within minutes. If verification fails, wait and try again.
Removing a Custom Domain
To remove a domain, go to Settings > Branding > Custom domains and click Remove on the domain card. You confirm the operation by typing the full domain name - after removal every public address on that domain stops working and links fall back to clarife.app. Delete the CNAME record from your DNS provider as well.
Can I use a root domain instead of a subdomain?
No. clarife requires a subdomain (e.g., docs.yourcompany.com) because root domains cannot have CNAME records in most DNS configurations.
Can I use multiple custom domains?
Yes - the Business plan lets you add up to 3 custom domains, for example a separate one per product. You assign each knowledge base to one of them in its settings.
Do existing share links break when I add a custom domain?
No. Links on clarife.app continue to work. The custom domain provides an additional URL for the same content.
Does the custom domain affect embedded documents?
Yes. You can update your embed code's src to use the custom domain URL. Both the custom domain and the default clarife.app URL work in embeds.