$ structure

Sites

A site is a self-contained website on its own subdomain. One account can run several of them, each with its own pages, layouts, domains, forms, and analytics.

Account → Site → Page

hostdocs is organised in three levels. An account (your personal account or an organization) owns one or more sites; each site owns its pages. Every account starts with a default site, so you never have to think about sites until you want a second one.

  • Each site has its own subdomain <site-slug>.hostdocs.io — and a page’s live URL is on its site’s subdomain.
  • A site owns its page layouts, custom domains, forms, collections, and analytics — they don’t cross between sites.
  • Path uniqueness is per site: two sites can each have a page at /about.

The site switcher

The dashboard is scoped to one site at a time. The header has an Org / Site switcher: pick the organization (or your personal account), then the active site. Everything you see — Pages, Layouts, Collections, Domains, Analytics — belongs to the site you have selected.

  1. Open the site switcher in the dashboard header.
  2. Choose an existing site, or New site to create one (it gets its own subdomain slug).
  3. The dashboard reloads scoped to that site; new pages and collections land there.

How many sites you can create

Every account always gets its one default site. Paid plans unlock more:

  • Free — 1 site.
  • Personal — 1 site.
  • Team — 1 per seat, up to 5.
  • Pro — 1 per seat (no fixed cap).

Custom domains attach to a site

By default a site is reached on its .hostdocs.io subdomain. Bind a custom domain to a site to serve that site from your own hostname instead.