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

# Workspaces

> Organize your AI conversations by project, team, or topic

Workspaces help you keep your AI conversations organized. Think of them as separate spaces for different areas of your
work.

## Types of Workspaces

<CardGroup cols={2}>
  <Card title="Personal Workspaces" icon="user">
    Private spaces just for you. Keep conversations organized by project or topic.
  </Card>

  <Card title="Shared Workspaces" icon="users">
    Invite teammates to collaborate. Everyone sees the same conversations.
  </Card>
</CardGroup>

***

## Creating a Workspace

<Steps>
  <Step title="Open the Sidebar">Click the workspace dropdown in the sidebar</Step>
  <Step title="Click 'Create Workspace'">Choose a name and optional icon</Step>
  <Step title="Start Organizing">Create folders and move conversations</Step>
  <Step title="Share with Team">When ready, invite teammates to collaborate</Step>
</Steps>

***

## Workspace Features

### Folders & Organization

Group related conversations together:

* **Create folders** for projects, clients, or topics
* **Drag and drop** chats between folders
* **Auto-assign** — set rules to automatically sort new chats
* **AI reorganization** — let AI suggest how to organize your chats

### Workspace Context

<Info>**New Feature**: Set context that applies to all conversations in a workspace.</Info>

Add background information that the AI should always know:

```
You are helping me with the Acme Corp project.
The tech stack is React, Node.js, and PostgreSQL.
The deadline is Q1 2025.
```

Workspace instructions are applied across conversations in that workspace. For uploaded documents, Mantle retrieves only
the passages relevant to the current request instead of attaching every file to every prompt. When a workspace agent is
used, its own relevant passages can be combined with the shared Workspace Context under the same permission checks.

### Bulk Management

Manage multiple chats at once:

* **Select multiple** chats with checkboxes
* **Bulk archive** old conversations
* **Bulk delete** what you no longer need
* **Move to folder** in one action

***

## Shared Workspaces

### Inviting Team Members

<Steps>
  <Step title="Go to Settings">Open Settings from the sidebar</Step>
  <Step title="Open Members">Click on the Members section</Step>
  <Step title="Click Invite">Generate an invite link with your preferred expiration time</Step>
  <Step title="Share the Link">Copy and send the link to your teammates</Step>
</Steps>

### Member Roles

| Role       | Can Do                                               |
| ---------- | ---------------------------------------------------- |
| **Owner**  | Full control, transfer ownership, manage members     |
| **Admin**  | Invite/remove members, change roles, manage settings |
| **Member** | Create and join chats, participate in channels       |

### Collaboration Features

When working in a shared workspace:

* **See who's online** — presence indicators show active members
* **Know who's typing** — typing indicators in real-time
* **React to messages** — emoji reactions for quick feedback

***

## Best Practices

<AccordionGroup>
  <Accordion icon="lightbulb" title="One Workspace Per Project">
    Keep conversations focused. Create a new workspace for each major project or client.
  </Accordion>

  <Accordion icon="folder" title="Use Folders for Subtopics">
    Within a project workspace, use folders for different aspects: "Research", "Code", "Meetings", etc.
  </Accordion>

  <Accordion icon="broom" title="Archive Regularly">
    Keep your workspace clean by archiving completed conversations. You can always find them later.
  </Accordion>

  <Accordion icon="users" title="Set Context for Teams">
    In shared workspaces, set workspace context so everyone's conversations have the same background info.
  </Accordion>
</AccordionGroup>

***

## Workspace Limits

| Plan     | Personal Workspaces | Shared Workspaces |
| -------- | ------------------- | ----------------- |
| **Free** | Unlimited           | Unlimited         |
| **Pro**  | Unlimited           | Unlimited         |
| **Team** | Unlimited           | Unlimited         |

<Card title="Need Organization Billing?" icon="crown" href="/plans">
  Shared workspaces are available on Free and Pro. Choose Team when your company needs one invoice, seat management, and
  organization billing controls.
</Card>