Custom domains

Point any domain you own at your Docsio docs site. SSL is automatic, setup takes about three minutes, and it's free on every plan.

Add the domain

Project settings → Publishing → Custom domain → enter the full domain you want to use:

docs.yourcompany.com (most common)
help.yourproduct.io
manual.yoursite.org
Apex domains supported (yourcompany.com)

Click Connect domain.

Add the DNS record

Docsio shows you the exact DNS record to create at your registrar. Two options depending on what kind of domain:

Subdomain (e.g. docs.yourcompany.com):

Type	Name	Value
`CNAME`	`docs`	`cname.docsio.co`

Apex domain (e.g. yourcompany.com):

Type	Name	Value
`A`	`@`	(Docsio shows the right IP)

Add the record at your DNS provider (Cloudflare, Namecheap, GoDaddy, Route 53 — same record, slightly different UIs). DNS propagation takes anywhere from a minute to an hour, but usually under five minutes.

SSL

Docsio provisions an SSL certificate automatically once DNS resolves. No action on your side. Renewal is automatic for the lifetime of the domain.

You'll see a green "Active" status next to the domain in settings when SSL is live.

Verifying ownership for shared domains

If your domain is registered with another platform (Vercel, Netlify, etc.), you may need a one-time TXT verification:

Type	Name	Value
`TXT`	`_vercel.yourcompany.com`	`vc-domain-verify=...`

Docsio shows the exact value when needed. Add the TXT record, click Verify. After verification, the regular CNAME or A record routes traffic to Docsio.

Multiple domains

You can point multiple domains at the same Docsio site (e.g. docs.acme.com and manual.acme.com). Both work, both get SSL. Add each in settings.

Switching domains later

Change the domain at any time in settings. Add the new one, verify, switch traffic. The old domain serves a 301 redirect to the new one for a configurable period (default 30 days), then deactivates.

Subpath domains

Want docs at yourcompany.com/docs instead of a subdomain? Two ways:

Reverse proxy at your main site forwarding /docs/* to your Docsio site. Cloudflare Workers, Vercel rewrites, or NGINX all work.
Iframe. Less ideal but supported.

We recommend a subdomain (docs.yourcompany.com) — simpler, faster, more reliable.

Common gotchas

DNS not resolving? Wait 5 minutes, then 15. If still nothing, double-check the record at your registrar.
CAA records blocking SSL. If you have CAA records that don't include letsencrypt.org, our SSL provider can't issue. Add 0 issue "letsencrypt.org" or remove the CAA records.
Cloudflare proxy. If you proxy through Cloudflare (orange cloud), set SSL/TLS mode to Full or Full (strict) — not Flexible.

Troubleshooting

If the domain doesn't activate after 15 minutes:

Check the DNS record propagated: dig docs.yourcompany.com CNAME should return cname.docsio.co.
Refresh the settings page — Docsio re-checks every minute.
If still failing, click Reset and retry in settings, or contact support with the domain name.

Free vs Pro

Custom domains are free on every plan. Both Free and Pro Docsio sites can have a custom domain with SSL. The only difference: Pro sites also get the Built with Docsio badge removed, doc versioning, search bar, and other Pro features.