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

# Workspaces

> Organize your work with dedicated workspaces

Workspaces are separate environments that let you organize your work in IllumiChat. Each workspace has its own assistants, chat history, projects, contacts, and settings. Use workspaces to separate different clients, teams, departments, or use cases.

## Creating a Workspace

<Steps>
  <Step title="Open the workspace switcher">
    Click on your workspace name in the top-left corner of the sidebar.
  </Step>

  <Step title="Create a new workspace">
    Select **Create Workspace** from the dropdown menu.
  </Step>

  <Step title="Enter workspace details">
    Give your workspace a name and an optional description, then confirm.
  </Step>
</Steps>

You are automatically assigned the **Owner** role for any workspace you create.

## Switching Between Workspaces

Click on the workspace name in the top-left corner of the sidebar to see all workspaces you belong to. Select a workspace to switch to it. Each workspace maintains its own:

* Chat history and conversations
* Custom assistants
* Projects and documents
* Contacts
* Member list and roles
* Settings and configuration

## Workspace Settings

Owners and admins can manage workspace settings by navigating to **Settings** in the sidebar.

* **Rename** the workspace
* **Update the description** to help members understand its purpose
* **Delete the workspace** (owner only) -- this permanently removes all data

<Warning>
  Deleting a workspace is irreversible. All assistants, chats, projects, documents, and contacts within the workspace will be permanently removed.
</Warning>

## Role-Based Access Control

Every workspace member is assigned a role that determines what they can do.

| Role       | Description                     | Key Permissions                                                |
| ---------- | ------------------------------- | -------------------------------------------------------------- |
| **Owner**  | Full control over the workspace | Billing, delete workspace, manage all settings, manage members |
| **Admin**  | Day-to-day management           | Manage members, assistants, projects, and settings             |
| **Member** | Standard usage                  | Use assistants, create chats, view shared content              |
| **Guest**  | Limited access                  | Read-only access to select resources                           |

<Note>
  Every workspace must have at least one owner. If you need to step down, transfer ownership first.
</Note>

## Managing Members

### Inviting Members

<Steps>
  <Step title="Go to Settings">
    Open **Settings** from the sidebar, then select the **Members** tab.
  </Step>

  <Step title="Click Invite">
    Click the **Invite** button.
  </Step>

  <Step title="Enter details">
    Enter the person's email address and choose a role (Admin, Member, or Guest).
  </Step>

  <Step title="Send the invitation">
    Confirm to send the invitation. The invitee will receive an email with a link to join.
  </Step>
</Steps>

### Changing a Member's Role

Owners and admins can change a member's role from the **Members** tab in Settings. Click on a member's current role to select a new one.

### Removing Members

To remove a member, go to the **Members** tab in Settings and click the remove option next to the member's name. Removed members immediately lose access to the workspace.

<Tip>
  Create separate workspaces for different projects, clients, or departments. This keeps your assistants, documents, and conversations organized and ensures each team only sees what is relevant to them.
</Tip>