Workspaces

A workspace is one docs site. Use separate workspaces for separate products, APIs, teams, or permission boundaries.

Create a workspace

1. Open Admin > Settings > Workspaces.
2. Select New workspace.
3. Add a name and color.
4. Save.

The workspace is available at:

/docs/{workspace}

Access mode

Set how a whole workspace is exposed in Admin > Settings > Publishing. Each workspace has one access mode:

• Public: anyone can read published public articles without signing in.
• Internal: members only. Signed-out visitors get a "sign in to view" prompt instead of a 404.
• Private: hidden entirely. Signed-out visitors get a 404 and cannot discover the workspace.

Locked, encrypted, archived, and unpublished pages stay hidden regardless of the mode.

Sidebar

Use sidebar sections to group articles. Keep top-level sections task based:

• Quickstart
• Guides
• Reference
• Troubleshooting

Landing page

Each workspace has its own landing page with search, categories, popular links, and footer links. Use it to guide readers to the most common tasks.