> ## Documentation Index
> Fetch the complete documentation index at: https://paper.brimble.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a workspace

> A workspace holds projects shared with a team.

A **workspace** holds projects shared with a team. Workspaces are billed separately from your personal account and have their own seats, concurrent builds, and projects.

This guide covers creating a paid team workspace from scratch. To invite people into an existing workspace, see [Manage teams](/workspaces-and-teams/manage-teams).

## Prerequisites

* A Brimble account with 2FA recommended (the workspace owner has full control of billing).
* A payment method on file. The workspace is charged immediately on creation.

## Step 1: Name and slug

1. Click your avatar → **New workspace**.
2. Fill in:
   * **Workspace image**, optional logo (PNG, JPG, or WebP).
   * **Workspace name**, the human name (e.g. "Acme Engineering").
   * **Workspace URL**, the slug used in URLs. Auto-generated from the name; edit if you need something specific. The slug is the part after `brimble.app/` in workspace links.
3. Click **Continue**.

<Frame caption="Step 1: name the workspace and pick its URL slug.">
  <img src="https://mintcdn.com/brimble-86/3qGOJm9m5-UVyrwq/images/workspaces-and-teams/workspace-creation-1.jpeg?fit=max&auto=format&n=3qGOJm9m5-UVyrwq&q=85&s=505a50ae38923fa3cabb568a068dbbe3" alt="Workspace creation step 1 with the workspace image upload, name field, and URL slug input prefixed by the brimble.app domain" width="5088" height="3366" data-path="images/workspaces-and-teams/workspace-creation-1.jpeg" />
</Frame>

## Step 2: Size and concurrent builds

This step sets the workspace's monthly cost.

| Setting                | Description                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Team size**          | Number of seats. Pick from 3, 5, 10, 15, 25, or 50. Each seat costs **\$5/month**.                                  |
| **Concurrent builds**  | How many builds can run in parallel. Minimum **2**. Each concurrent build slot costs **\$8/month**.                 |
| **Startup promo code** | Optional. If you have one, enter it and click **Verify**. Valid codes apply a discount; invalid ones show an error. |

The page shows a running total: `seats × $5 + builds × $8 = $X/month`.

A workspace with **3 seats and 2 concurrent builds** is `3 × $5 + 2 × $8 = $31/month`.

You can change both values later under **Workspace settings → Billing**, but you can't go below the seats currently in use without removing members first.

Click **Continue**.

<Frame caption="Step 2: pick team size and concurrent build slots, with the running monthly total.">
  <img src="https://mintcdn.com/brimble-86/3qGOJm9m5-UVyrwq/images/workspaces-and-teams/workspace-creation-2.jpeg?fit=max&auto=format&n=3qGOJm9m5-UVyrwq&q=85&s=4e8f4ec7ab9a404a7f48b8abc4299bdd" alt="Workspace creation step 2 with team-size selector, concurrent-builds selector, optional startup promo code field, and the running monthly cost summary" width="5088" height="3366" data-path="images/workspaces-and-teams/workspace-creation-2.jpeg" />
</Frame>

## Step 3: Invite members

Invite the people who'll be in the workspace. For each row:

* **Email**, the invitee's address. They'll get an email with a link.
* **Role**, pick from `Member`, `Administrator`, or `Viewer`. The Creator role is reserved for the workspace owner.

Click **Add another** to invite more. You can leave this step empty and invite people later.

The page shows a billing summary: seats cost + builds cost + total. If you've added more invites than your team size, a warning appears: "You've invited N members but only have M seats, additional seats will be charged."

You can't invite yourself, Brimble blocks the email matching your account.

<Frame caption="Step 3: invite teammates by email and assign each a role, with the billing summary.">
  <img src="https://mintcdn.com/brimble-86/3qGOJm9m5-UVyrwq/images/workspaces-and-teams/workspace-creation-3.jpeg?fit=max&auto=format&n=3qGOJm9m5-UVyrwq&q=85&s=a89edd1777b754a72fb3b8556c04347d" alt="Workspace creation step 3 with rows of email and role inputs, an Add another button, and the seats plus builds billing summary" width="5088" height="3366" data-path="images/workspaces-and-teams/workspace-creation-3.jpeg" />
</Frame>

## Step 4: Create

Click **Create workspace**. The card on file is charged immediately for the first month.

After creation:

* The workspace appears in the workspace switcher in the top-left.
* Pending invites send out as emails.
* You become the **Creator** of the workspace.

## After creation

Things you'll typically do next:

* **Create a project** under the workspace. Switch into the workspace via the switcher and click **New project**.
* **Set up webhooks** for the workspace under **Settings → Webhooks**.
* **Configure 2FA** on your account if you haven't, required for ownership transfer.
* **Adjust limits.** Bumping seats or builds is one click in **Settings → Billing**.

## Switching between workspaces

The workspace switcher in the top-left of the dashboard groups your workspaces:

* **Personal Accounts**, your individual workspace.
* **Teams**, every team workspace you're a member of.

Switching context filters the project list, the dashboard home, and most settings to the active workspace.

## Roles and what each can do

| Role              | Permissions                                                                                         |
| ----------------- | --------------------------------------------------------------------------------------------------- |
| **Creator**       | Full control. Manages billing, members, projects. Can transfer ownership. One per workspace.        |
| **Administrator** | Same as Creator except can't transfer ownership.                                                    |
| **Member**        | Read and write to projects. Deploy, manage env vars, add domains. Cannot manage billing or members. |
| **Viewer**        | Read-only across projects, deployments, logs.                                                       |

## Troubleshooting

**"Card declined" on creation.** The card on file failed when Brimble tried to charge for the first month. Add a different card under **Billing → Payment methods** and try again. The workspace doesn't get created until payment goes through.

**Promo code says "invalid."** Codes are case-sensitive and time-limited. Re-check exactly as provided. If it's still rejected, contact whoever gave you the code, promo codes can be revoked or expire without warning.

**Invitee never got the email.** Check spam. Revoke the pending invite from **Settings → Members** and re-invite to the right address. Typos are the most common cause.

## Next steps

* [Manage teams](/workspaces-and-teams/manage-teams), invite people, change roles, transfer ownership.
* [Plans and pricing](../billing/plans), full pricing breakdown including overages.
* [Two-factor authentication](/security/two-factor-authentication), required for ownership transfer.