Documentation

Custom domains

Serve your docs from your own domain, such as docs.yourcompany.com, with automatic SSL.

On this page 4

Serve a site from your own address, such as docs.yourcompany.com. SSL certificates are issued and renewed for you.

Custom domains are included on the Starter and Pro plans. Your site's free subdomain keeps working throughout, as a preview and a fallback.

Add a domain

  1. Open the site and go to the Domain tab, then click Configure custom domain.
  2. Enter the Hostname, such as docs.yourcompany.com, and click Add domain.
  3. Add the DNS records shown on the page at your DNS provider.

You can also add a domain while creating a site by choosing Custom domain in the wizard.

DNS records

Add two kinds of record where your domain's DNS is managed:

  1. A CNAME record for your hostname, pointing to maddiedocs.com.
  2. The validation records listed under your domain on the Custom domains page. They prove you own the domain and let the SSL certificate be issued. Copy each record's type, name and value exactly.

DNS changes can take a while to spread. The page checks for you every 15 seconds while you're on it, and in the background until it succeeds. Click Refresh to check now.

Statuses

Status Meaning
Pending, pending validation Waiting for the DNS records to be found
Active The domain is verified and serving your docs
Failed, timed out Verification didn't complete

If a domain isn't verified within 12 hours it times out. Check the records, then click Start again to retry.

Remove a domain

Click Remove beside the domain. Your site carries on at its free subdomain.