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:

TypeNameTarget
CNAMEdocscustom.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.