A site is one documentation website with its own address, pages and theme. See every site on your team under Sites; each row shows where its pages come from, its status, how many pages and drafts it has, and when it last changed.
Two kinds of site
| Editor site | GitHub site | |
|---|---|---|
| Where you write | In the browser, with the editor | In your repository, in any editor you like |
| How changes go live | Click Publish | Push to your production branch |
| Best for | Product docs, help centres, handbooks | Docs that live alongside code |
You choose when you create the site. See GitHub sync for repository-backed sites.
The site page
Click a site to open its page. The header has Visit (the live site), Open editor or View pages, and, for GitHub sites, Resync.
| Tab | What's there |
|---|---|
| Overview | Page count, when it last changed, its status and the most recent changes |
| History (editor sites) or Deployments (GitHub sites) | Every publish or sync: what changed, who did it, whether it worked and when |
| Domain | The site's free subdomain and its custom domain |
| Settings | The repository, theme, MCP endpoint, GitHub webhook and deleting the site |
Statuses
| Status | Meaning |
|---|---|
| Live | The site is serving your docs |
| Syncing | A sync or setup is in progress |
| Error | The last sync failed; the history says why |
| Suspended | The site has been suspended. It isn't served and can't be edited. Contact support if you think this is a mistake |
Site limits
Each plan includes a number of sites: 1 on Free, 3 on Starter and 10 on Pro. The Overview shows how many you've used. When you reach the limit, upgrade from Billing to add more.
Delete a site
Go to Settings → Danger zone → Delete this site and confirm with your password. The site goes offline straight away.
- Contact support within 30 days if you need it back.
- Its subdomain stays reserved for 90 days, so nobody else can take it while search engines catch up.