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

# Workspaces

> Organize and control access to subsets of your cloud cost data. A workspace can model a security group, department, MSP customer or anything that fits your organizational structure.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/pelanor-6a347cfc/images/workspaces-1.png" alt="Workspaces Image" />
</Frame>

## What are Workspaces?

Workspaces allow you to scope and isolate data and access within Pelanor.

**Key benefits:**

* **Security & RBAC** – restrict sensitive or production data to authorised users
* **Multi-tenant support** – MSPs can create a Workspace per tenant so each customer sees only their own data

***

## Default Workspace

The **Default Workspace** shows all data Pelanor can access and is used for global user and workspace management.

<Warning>
  Limit access to the **Default Workspace** to Administrators only.
</Warning>

***

## Managing Workspaces

Only **Admin** users in the **Default Workspace** can create, edit, or delete Workspaces.

### Creating a Workspace

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/pelanor-6a347cfc/images/workspaces-3.png" alt="Creating Workspace" />
</Frame>

Before creating a Workspace, ensure that the relevant **Dimension** and **Groups** are already defined.\
Refer to the [Dimensions and Groups](/dimensions) documentation for help.

<Steps>
  <Step title="Open Workspaces">
    Go to **Settings → Workspaces**.
  </Step>

  <Step title="Add new Workspace">
    Click **Add Workspace**.
  </Step>

  <Step title="Select Group(s)">
    Expand a Dimension (e.g., *Business Unit*) and select one or more Groups.
  </Step>

  <Step title="Configure">
    Click **Next**, and optionally apply discount rules for this Workspace.
  </Step>
</Steps>

***

### Editing a Workspace / Managing Users

To make changes:

1. Go to **Settings → Workspaces**
2. Click the **⋯ Actions** menu next to a Workspace → **Edit workspace**

You can update:

* **Workspace name**
* **Workspace users** – add, remove, or change roles

<Info>
  Users must be created under **Settings → Users** before they can be added to a Workspace.
</Info>

***

### Removing a Workspace

* Go to **Settings → Workspaces**
* Click the **Actions** (⋯) icon next to a Workspace
* Select **Delete**

<Warning>
  The **Default Workspace** cannot be deleted.
</Warning>

***

## Changing Workspaces

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/pelanor-6a347cfc/images/workspaces-2.png" alt="Switching Workspaces" />
</Frame>

If a user belongs to multiple Workspaces, they can switch between them using the profile dropdown in the top-right corner of the Pelanor interface.