For the complete documentation index, see llms.txt. This page is also available as Markdown.

What's the difference between a workspace and a project?

Understand the difference between workspaces and projects, and when to use each.

A workspace is your top-level organisational container — think of it as your company or team's home. Everything lives inside a workspace: members, billing, settings, and all your projects.

A project is where your actual work happens. Each project has its own content, permissions, and settings, but it always belongs to a workspace.

Quick comparison

Workspace
Project

Contains

Members, projects, billing

Content, pages, files

Billing

Per workspace

Inherited from workspace

Permissions

Org-wide roles

Project-level roles

Limit

1 per account (Free)

Unlimited

When to create a new workspace vs. a new project

Create a new project when you're starting a distinct piece of work — a new product, a separate documentation site, or a team initiative. Projects are cheap and easy to manage.

Create a new workspace only when you need a completely separate billing and membership boundary — for example, an agency managing work for a different client, or a personal account kept separate from your employer.

  • Inviting team members to your workspace

  • Setting up a custom domain

Was this helpful?