$ structure

Custom domains

Bring your own domain and serve your pages from it, with TLS provisioned for you.

Availability

Custom domains are a paid feature. The number you can add depends on your plan:

  • Free — not available (pages are served on your hostdocs subdomain).
  • Personal — 1 custom domain.
  • Team — 1 per seat, up to 5.
  • Pro — 1 per seat (no fixed cap).

Connect a domain

  1. In the dashboard, open Domains and add your hostname (e.g. www.example.com).
  2. hostdocs shows you the DNS records to add at your registrar — a CNAME pointing your hostname at the hostdocs target, plus a TXT record used to verify ownership.
  3. Add those records in your DNS provider, then choose Verify back in the dashboard.
  4. Once verified, hostdocs provisions a TLS certificate and begins serving the site’s pages on the domain. Status shows as active when it’s live.

DNS can take a moment

DNS changes can take a few minutes (sometimes longer) to propagate. If verification doesn’t succeed immediately, wait and try again.

Domains attach to a site

A custom domain serves one site. Bind the verified domain to the site whose pages it should show; an unbound domain falls back to the account’s default site. To serve a different set of pages from a different domain, create another site and bind the domain to it.