Docs/Deployment/Custom Domain

Custom Domain

Serve your Help Page from your own domain — for example help.yourcompany.com or chat.yourcompany.com — so visitors see your brand in the address bar instead of aichatvault.com. HTTPS is provisioned automatically.

What you can map

When adding a custom domain, choose which channel it applies to:

Domain typeWhat it serves
Help PageYour custom domain shows the standalone help page only.
WidgetYour custom domain is used as the widget embed origin (for strict CSP policies).
BothThe domain handles both the help page and widget origin — most common choice.

Setting up a custom domain

1

Open Deploy → Custom Domain

In your agent's Deploy section, click Custom Domain.
2

Enter your subdomain

Type the full subdomain you want to use, for example help.yourcompany.com. Root domains (without a subdomain) are not supported — use a subdomain.
3

Choose the domain type

Select Help Page, Widget, or Both depending on what you want this domain to serve.
4

Save the domain

Click Save Domain. The dashboard shows the DNS target you need to point to.
5

Add a CNAME record in your DNS provider

Log in to your DNS provider (Cloudflare, GoDaddy, Namecheap, Route 53, etc.) and add a CNAME record:
Record typeHost / NameValue / Target
CNAMEhelp (or your chosen subdomain)www.aichatvault.com
6

Wait for DNS propagation

DNS changes typically propagate within 5–30 minutes, but can take up to 24 hours depending on your provider's TTL settings.
7

Click Verify DNS

Return to the Custom Domain page and click Verify DNS. The system checks that your CNAME is pointing correctly.
8

SSL is provisioned automatically

Once DNS is verified, HTTPS is automatically set up. Your help page will be live on your custom domain within a few minutes.

Domain status lifecycle

StatusMeaning
PendingDomain saved, waiting for DNS verification.
DNS VerifiedCNAME record confirmed — SSL provisioning has started.
SSL ProvisioningCertificate is being generated. Usually completes within 1–2 minutes.
ActiveDomain is fully configured and your help page is live on it.
FailedSSL provisioning failed — usually because DNS is not yet propagated. Try verifying again after 30 minutes.

Removing a custom domain

To remove a custom domain, click Remove Domain on the Custom Domain page. This immediately disconnects the mapping — the help page reverts to its default AIChatVault URL. Delete the CNAME record from your DNS provider afterwards to avoid a dangling DNS entry.

⚠️
Custom domains require a paid plan. If you downgrade to the free plan while a custom domain is active, the domain mapping will stop working and the help page will only be accessible at the default URL.
💡
If your DNS provider is Cloudflare, make sure the CNAME record is set to DNS only (grey cloud), not Proxied (orange cloud). Cloudflare proxying can interfere with SSL provisioning on third-party platforms.

Was this page helpful?