# Workspaces



## What is a Workspace? [#what-is-a-workspace]

A Workspace is the central place where you manage and organize your work in Ideavo. Every project belongs to a workspace, and all collaboration, settings, and credits are managed from there.

When you sign up for Ideavo, a default workspace is created automatically with 5 free credits. This workspace acts as your primary workspace and is included with the free plan.

Inside a workspace, you can:

* Create and manage projects
* Organize your work
* Manage workspace-level credits
* Configure workspace settings
* Collaborate with others

All credits in Ideavo are managed at the workspace level, meaning credits belong to the workspace rather than individual projects.

<DocImage src="features/workspaces/workspace-switcher" alt="Workspace switcher open in the sidebar with the current workspace, Invite members, another workspace and Create workspace" width="576" height="632" />

## Workspace Details [#workspace-details]

### Limits [#limits]

Users on the free plan can have up to 2 workspaces at a time. To create additional workspaces, you must upgrade to the Pro plan in your default workspace.

<DocImage src="features/workspaces/create-workspace" alt="Create workspace dialog with a name field and Cancel and Create buttons" width="896" height="496" />

### Default Workspace [#default-workspace]

Every user always has a default workspace, which is created automatically during signup and cannot be removed. Only the default workspace receives 5 free credits each month — any additional workspaces start with zero credits and no plan.

### What Belongs to a Workspace [#what-belongs-to-a-workspace]

The following settings are currently tied to your user account but will move to the workspace level:

| Feature                                                              | Before  | After     |
| -------------------------------------------------------------------- | ------- | --------- |
| [MCP Servers](/docs/features/mcp) — User level                       | User    | Workspace |
| [MCP Servers](/docs/features/mcp) — Project level                    | Project | Project   |
| [LLM Providers (BYOK)](/docs/features/byok)                          | User    | Workspace |
| [Sandbox](/docs/features/sandbox)                                    | User    | Workspace |
| [Integrations](/docs/features/integration) (GitHub, Vercel, Railway) | User    | Workspace |
| Folders, Projects                                                    | User    | Workspace |
| Top-ups                                                              | User    | Workspace |
| Plan / Subscription                                                  | User    | Workspace |

<Callout type="warn">
  **Existing User Migration** — If you already have an Ideavo account without a workspace, you will be automatically migrated to a default workspace. All your existing projects, folders, and credits will be moved into that workspace automatically.
</Callout>

## Roles & Permissions [#roles--permissions]

Workspace owners and admins can manage workspace members, billing, and settings.

### Workspace Roles [#workspace-roles]

| Role       | Description                                                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**  | Full control over the workspace. Created automatically as the workspace creator. Can manage billing, members, and all settings. |
| **Admin**  | Can manage members, credits, and workspace settings. Cannot delete the workspace, transfer ownership, or invite other admins.   |
| **Editor** | Can create and edit projects within the workspace. Cannot manage members or billing.                                            |
| **Viewer** | Read-only access to projects within the workspace.                                                                              |

* Only the owner can delete a workspace. Default workspaces cannot be deleted.
* Admins can manage members and rename the workspace, but only the owner can invite users with the Admin role.
* Each workspace has exactly one owner. Ownership is non-transferable.

### Inviting Members [#inviting-members]

Workspace owners and admins can invite users to the workspace by email with an assigned role. Invited users receive an email invitation and join the workspace upon accepting.

<DocImage src="features/workspaces/workspace-members" alt="Workspace Members dialog listing people with their roles and two pending invitations" width="896" height="972" />

### Project-Level Access [#project-level-access]

Each project within a workspace can also be individually shared with collaborators outside the workspace. See [Collaboration](/docs/features/collaboration) for details.

<Callout type="warn">
  Workspace roles always take precedence over project-level roles.
</Callout>

## FAQ [#faq]

<Accordions>
  <Accordion title="How many members can one workspace have?">
    There is no limit on the number of members in a workspace.
  </Accordion>

  <Accordion title="Can I have several workspaces?">
    Yes. Free plan users can have up to 2 workspaces. Pro plan users can create additional workspaces beyond that.
  </Accordion>

  <Accordion title="Can I switch between workspaces?">
    Yes. Use the workspace switcher in the sidebar to switch between your workspaces.
  </Accordion>

  <Accordion title="Can I change the workspace owner?">
    No. Ownership is non-transferable. Each workspace has exactly one owner.
  </Accordion>

  <Accordion title="Can I move a project to a different workspace?">
    No. Projects are tied to the workspace they were created in and cannot be moved.
  </Accordion>

  <Accordion title="Are credits shared across workspaces?">
    No. Each workspace has its own independent credit balance. Credits cannot be transferred between workspaces.
  </Accordion>

  <Accordion title="How long do workspace credits last?">
    Credits behave the same way as they do in the default workspace. See the [Pricing](/docs/introduction/pricing) page for details.
  </Accordion>
</Accordions>
