Custom Domain Setup
Connect your own domain to your documentation site for a professional, branded experience.
Overview
A custom domain allows you to serve your documentation from your own domain (for example, docs.yourcompany.com) instead of the default Documentation.AI subdomain. This creates a seamless, branded experience for your users.
Custom domains require DNS configuration with your domain provider. The setup process typically takes a few minutes, but DNS propagation can take up to 24 hours.
Prerequisites
Before setting up a custom domain, ensure you have:
A domain you own with access to DNS settings
Administrative access to your DNS provider (for example, Cloudflare, GoDaddy, Namecheap, Route 53)
Add your custom domain
Navigate to Domain Settings
-
Log in to your Documentation.AI dashboard
-
Select your project
-
Go to Settings → Domain Settings
Enter your domain
In the Custom Domains section, enter your domain in the input field (for example, docs.yourcompany.com).
Click the Add button to register your domain.
Configure DNS records
After adding your domain, Documentation.AI will display the exact DNS records you need to add to your DNS provider. Depending on your configuration, you may see a combination of A or CNAME, and TXT records. All records shown in the dashboard must be added.
A common configuration includes a CNAME record such as:
| Type | Name | Value |
|---|---|---|
| CNAME | docs | your-project.documentationai.com |
Additional A or TXT records may appear for routing or verification and should be entered exactly as shown in your dashboard.
Always rely on the specific records displayed in your Documentation.AI dashboard. They reflect the correct values for your project.
Add DNS records to your provider
Log in to your DNS provider and add the records shown in your Documentation.AI dashboard.
Common DNS providers:
-
Cloudflare: DNS → Records → Add record
-
GoDaddy: DNS Management → Add → CNAME
-
Namecheap: Advanced DNS → Add New Record
-
Route 53: Hosted zones → Create a record
-
Google Domains: DNS → Custom records → Manage custom records
Disable proxy mode
If you are using Cloudflare or another DNS provider with proxy capabilities, you must disable the proxy (orange cloud) for your documentation domain record.
When proxy mode is enabled, requests are routed through the provider's servers, which can interfere with SSL certificate generation and domain verification.
To disable proxy in Cloudflare:
-
Go to your Cloudflare dashboard
-
Select your domain
-
Navigate to DNS → Records
-
Find the CNAME record for your documentation subdomain
-
Click the orange cloud icon to toggle it to grey (DNS only)
-
Save your changes
The record should show DNS only status, not Proxied.
Verify domain connection
After configuring your DNS records:
Wait for DNS propagation
DNS changes can take anywhere from a few minutes to 24 hours to propagate globally. Most changes propagate within 1–2 hours.
Check verification status
Return to Settings → Domain Settings in your Documentation.AI dashboard.
Click the Refresh button to check the current verification status of your domain.
If verification fails, wait a few more hours and try again. DNS propagation times vary by provider and region.
Confirm SSL certificate
Once verified, Documentation.AI automatically provisions an SSL certificate for your domain. This ensures your documentation is served securely over HTTPS.
Re-publish your documentation
After your custom domain is verified and connected, you must re-publish your documentation for the changes to take effect.
Re-publish using one of these methods:
From the Web Editor:
-
Open your project in the web editor
-
Click Publish in the top navigation
-
Confirm the publish action
From the Overview page:
-
Go to your project dashboard
-
Click the Publish button
-
Wait for the deployment to complete
Your documentation will now be accessible at your custom domain.
Troubleshooting
Last updated 1 week ago