/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
Guides Custom Domains

Custom Domains

Set up a custom domain for your documentation site.

3 min read

Host your documentation at your own domain like docs.yourcompany.com instead of the default yourproject-docs.syntext.dev.

Requirements

•
Syntext Starter plan or higher (a wildcard hostname such as *.docs.example.com needs Pro)
•
Access to your domain's DNS settings

Setup Process

Step 1: Add Domain in Dashboard

1.
2.
Select your project
3.
Navigate to Settings › Domains
4.
Enter your domain under Add a hostname: docs.yourcompany.com
5.
Click Add — the DNS records to create appear under the domain, each with a copy button

Step 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:

TypeNameValue
CNAMEdocscname.syntext.dev
TXTas shown in the dashboardas shown in the dashboard
Note

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

1.
Click Check again next to the domain in Settings › Domains
2.
DNS propagation typically takes 5-30 minutes
3.
Once verified, SSL is automatically provisioned

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:

bash
stx deploy

DNS Provider Guides

Cloudflare

1.
Go to your domain's DNS settings
2.
Add a CNAME record:
◦
Name: docs (or your subdomain)
◦
Target: cname.syntext.dev
◦
Proxy status: DNS only (gray cloud)
Warning

Disable Cloudflare's proxy (orange cloud) for the docs subdomain. Syntext handles SSL and CDN.

AWS Route 53

1.
Go to your hosted zone
2.
Click Create Record
3.
Configure:
◦
Record name: docs
◦
Record type: CNAME
◦
Value: cname.syntext.dev
◦
TTL: 300

Google Domains

1.
Go to DNS settings
2.
Scroll to Custom records
3.
Add:
◦
Host name: docs
◦
Type: CNAME
◦
TTL: 3600
◦
Data: cname.syntext.dev

Namecheap

1.
Go to Advanced DNS
2.
Add new record:
◦
Type: CNAME
◦
Host: docs
◦
Value: cname.syntext.dev
◦
TTL: Automatic

SSL Certificates

SSL certificates are automatically provisioned and renewed:

•
Issued by: Cloudflare, on Syntext's behalf (DV, validated through the TXT record)
•
Renewal: Automatic

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:

json
{
"redirects": [
{ "from": "/old-page", "to": "/new-page" }
]
}

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

•
Confirm the CNAME and TXT records are correct
•
Wait up to 48 hours for DNS propagation
•
Check for conflicting records (A records, etc.)
•
Check that the TXT records from the dashboard are in place
•
Ensure no CAA records are blocking the certificate (see below)

SSL Certificate Error

•
Domain must point to cname.syntext.dev
•
CAA records (if any) must allow letsencrypt.org and pki.goog
•
Contact support if issues persist

Mixed Content Warnings

Ensure all assets (images, scripts) use HTTPS URLs. Relative URLs are recommended:

markdown
<!-- Good -->
![Screenshot](/images/screenshot.png)
<!-- Avoid -->
![Screenshot](http://example.com/screenshot.png)

Removing a Custom Domain

1.
Go to Settings › Domains
2.
Click Remove next to the domain and confirm
3.
Remove the DNS record from your provider

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.

Was this page helpful? Yes No
Product
Resources
Company
© 2026 SyntextBuilt with Syntext