# Workspaces

Workspaces are how FLORA organizes your projects, team members, and usage. Each workspace has its own plan, usage budget, and team — so it's important to make sure you're in the right one.

## Switching Workspaces

Click the **workspace selector** in the top-left corner of the dashboard. It shows your current workspace's logo, name, and member count.

The dropdown displays all workspaces you belong to, along with each workspace's **plan type** and **member count**. Your active workspace has a checkmark next to it. If you've been invited to a workspace you haven't joined yet, it will appear here with a **Join** button.

To switch, click any workspace in the list. FLORA remembers the last workspace you used, so you'll land there automatically next time you log in.

> **Tip:** If you belong to many workspaces, use the search bar at the top of the dropdown to find the one you need.

## Checking Your Usage

Each workspace has its own monthly usage budget. The app header shows a live percentage bar so you can see how much is left at a glance.

For a full breakdown, open your workspace settings and go to **Plan & Usage**. This page shows:

* **Current plan** — your plan name and monthly usage budget
* **Budget remaining** — how much you've used this cycle and your reset date
* **Extra usage** — usage carried over from migration, referrals, or grants. Consumed after your monthly budget each cycle, and doesn't expire.
* **Usage History** — exact dollar cost per generation, project, and member, useful for client billing and team budgets
* **Next Billing** — your next billing date and amount, with a **Manage** button to open your Stripe billing portal (admin only)

### Pooled or per-member usage

By default, every paid seat in a workspace draws from the same shared usage pool. Workspace admins have additional controls on the **Plan & Usage** page:

* **Pooled or per-user budgets.** Switch between a single shared pool (the default) and per-user budgets at any time.
* **Per-member caps.** Set a dollar cap on any individual member to prevent one person from draining the pool.
* **On-demand spending.** Opt in to keep generating after the monthly budget runs out, capped at a monthly limit you set.

### Why do I see no usage budget?

This is almost always because you're viewing the wrong workspace. If your plan is active and the budget shows empty:

1. Click the **workspace selector** in the top-left corner.
2. Look for the workspace that has your active plan (check the plan type shown next to each workspace name).
3. Switch to that workspace — your usage budget will appear in the header and under **Plan & Usage**.

## Creating a Workspace

To create a new workspace, click the **workspace selector** and select **Create a new workspace** at the bottom. The setup has three steps:

1. **Name** — choose a name for your workspace (minimum 3 characters).
2. **Plan** — select a billing plan.
3. **Invite team** — optionally invite team members by email. You can skip this step and invite people later.

## Inviting Team Members

Make sure you're in the correct workspace before inviting anyone. You can invite from two places:

* The **member count badge** in the top-right of the dashboard
* The **Invite** button on the People & Credits page

### Invite methods

* **Email** — enter one or more email addresses (separated by commas, semicolons, or spaces), choose a role, and send.
* **Link** — copy a shareable invite link. You can choose between an **edit link** or a **view link**.

### Roles

| Role   | Label    | Permissions                                                                                                      |
| ------ | -------- | ---------------------------------------------------------------------------------------------------------------- |
| Admin  | Admin    | Full permissions — manage billing, settings, and all workspace features. Can invite admins, editors, and guests. |
| Editor | Can edit | Can edit projects and invite editors and guests. Cannot manage billing.                                          |
| Guest  | Can view | View-only access. Cannot edit projects or invite others.                                                         |

## Workspace Settings

To access workspace settings, click the **settings icon** (gear) in the workspace header. Admin-only settings include:

* **Rename workspace** — edit the workspace name directly.
* **Upload logo** — click the workspace avatar to upload a custom image.
* **Model Access Control** — choose whether new AI models are available by default (opt-out) or must be manually enabled (opt-in), with per-model toggles.

Any member can **leave a workspace** from the settings page, as long as it's not their only workspace.

> **Note:** Workspaces cannot be deleted. If you no longer need a workspace, you can leave it.


---

# 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://docs.flora.ai/faqs-how-to.../workspaces.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.