Custom Domains
Configure a custom domain for your Syntext documentation.
Host your documentation at your own domain like docs.yourcompany.com instead of the default Syntext subdomain.
Prerequisites
*.docs.example.com needs Pro)Setup Process
- 01Step 1 of 41 ›Step 11.Add Domain in Dashboard1.Go to the Syntext dashboard2.Select your project3.Navigate to Settings › Domains4.Enter your domain under Add a hostname:
docs.yourcompany.com5.Click Add — the DNS records to create appear under the domain, each with a copy button - 02Step 2 of 42 ›Step 22.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.devTXT as shown in the dashboard as shown in the dashboard NoteDNS changes can take up to 48 hours to propagate, though most complete within 30 minutes.
- 03Step 3 of 43 ›Step 33.Verify Domain1.Return to Settings › Domains2.Click Check again next to the domain3.Wait for verification (usually 5-30 minutes)
- 04Step 4 of 44 ›Step 44.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:
bashstx deploy
DNS Provider Guides
Cloudflare
docscname.syntext.devDisable Cloudflare's proxy (turn off the orange cloud) for the docs subdomain. Syntext handles SSL and CDN.
AWS Route 53
docscname.syntext.devGoDaddy
docscname.syntext.devNamecheap
docscname.syntext.devGoogle Domains
docscname.syntext.devRoot Domain
To use a root/apex domain (e.g., docs.com instead of docs.example.com), you need a DNS provider that supports ALIAS or ANAME records:
| Provider | Record Type |
|---|---|
| Cloudflare | CNAME Flattening (automatic) |
| AWS Route 53 | ALIAS |
| DNSimple | ALIAS |
| NS1 | ALIAS |
Not all DNS providers support ALIAS records. If yours doesn't, use a subdomain like docs.yourcompany.com.
SSL Certificates
SSL certificates are automatically provisioned and renewed:
No manual configuration needed.
CAA Records
If your domain has CAA records, they must allow the certificate authorities Cloudflare issues from — Let's Encrypt and Google Trust Services:
Multiple Domains
Add multiple domains that all serve the same documentation:
docs.yourcompany.com (primary)developers.yourcompany.com (alias)help.yourcompany.com (alias)All domains serve identical content.
Removing a 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.
Troubleshooting
Domain Not Verifying
SSL Certificate Error
cname.syntext.devletsencrypt.org and pki.googMixed Content Warnings
Ensure all assets use HTTPS or relative URLs:
"Too Many Redirects"
If using Cloudflare: