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

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.

{% hint style="warning" %}
Switching content between workspaces is not straightforward. If in doubt, start with a new project inside your existing workspace.
{% endhint %}

### Related articles

* Inviting team members to your workspace
* Setting up a custom domain


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pro.cophieu79.vn/bao-cao-phan-tich/getting-started/whats-the-difference-between-a-workspace-and-a-project.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.