Documentation

Sites

Editor and GitHub sites, the site page, statuses and deleting a site.

On this page 6

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.

In this section