Custom Domains
Set up a custom domain for your documentation site.
Host your documentation at your own domain like docs.yourcompany.com instead of the default yourproject-docs.syntext.dev.
Requirements
*.docs.example.com needs Pro)Setup Process
Step 1: Add Domain in Dashboard
docs.yourcompany.comStep 2: Configure DNS
Add a CNAME record pointing to Syntext, plus the TXT records listed under the domain — one proves you own it, the other lets the certificate be issued:
| Type | Name | Value |
|---|---|---|
| CNAME | docs | cname.syntext.dev |
| TXT | as shown in the dashboard | as shown in the dashboard |
If you're using the root domain (e.g., docs.com instead of docs.example.com), you'll need to use an ALIAS or ANAME record. Not all DNS providers support this.
Step 3: Verify and Wait
Step 4: Deploy
Your docs are served on the domain as soon as it's verified. Deploy once more so the sitemap, canonical links and social cards use the new domain:
DNS Provider Guides
Cloudflare
docs (or your subdomain)cname.syntext.devDisable Cloudflare's proxy (orange cloud) for the docs subdomain. Syntext handles SSL and CDN.
AWS Route 53
docscname.syntext.devGoogle Domains
docscname.syntext.devNamecheap
docscname.syntext.devSSL Certificates
SSL certificates are automatically provisioned and renewed:
No manual intervention needed.
Multiple Domains
You can add multiple domains to one project:
docs.yourcompany.com (primary)developers.yourcompany.com (alias)All domains serve the same content.
Redirects
Redirect old paths
redirects in syntext.json match paths on your docs site, not other domains:
To send an old docs domain to the new one, set up the redirect at the old domain's DNS or hosting provider.
Redirect HTTP to HTTPS
Handled automatically. All HTTP requests redirect to HTTPS.
Troubleshooting
Domain Not Verifying
SSL Certificate Error
cname.syntext.devletsencrypt.org and pki.googMixed Content Warnings
Ensure all assets (images, scripts) use HTTPS URLs. Relative URLs are recommended:
Removing a Custom Domain
After removal, the site returns to yourproject-docs.syntext.dev.
The domain is released and can be added to another project. Deleting a project, or its workspace, releases all of its custom domains the same way. To move a domain, add it to the new project and set up the DNS records the dashboard shows for it.