> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/workspace/chat-groups.md).

# Chat Groups

Chat Groups organize your conversations by team or topic, so your team can find conversations easily.

### What is a Chat Group? <a href="#what-is-a-chat-group" id="what-is-a-chat-group"></a>

A Chat Group is a way to organize related conversations together. Instead of a cluttered sidebar with dozens of individual chats, Chat Groups let you group conversations by team, topic, or project, making it easier to find and manage conversations.

Each Chat Group can be connected to one or more Knowledge Bases, so all conversations in the group have access to the same knowledge by default.

### Where to find it?

Chat Groups are in the left sidebar under Workspace.

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FCUhcDTpaP0euwFxkJxzZ%2Fimage.png?alt=media&amp;token=c1e499ce-60bd-4109-866a-aa0a695289dc" alt="" width="241"><figcaption></figcaption></figure>

### Create a Chat Group <a href="#create-a-chat-group" id="create-a-chat-group"></a>

1. In the left sidebar, select Chat Groups.
2. Select + New group or the + icon.
3. Name your group (e.g., "Marketing Team", "Product Updates", "Client Research").
4. Select Create.

Your Chat Group is now ready for conversations.

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FONEnsfPeWKyOBithEdH2%2Fimage.gif?alt=media&amp;token=e4a39961-1171-4c84-aa9e-3aa3ab64a933" alt=""><figcaption></figcaption></figure>

### **Add chats to a Chat Group**

**You can add chats to a Chat Group in two ways:**

**Method 1: Move an existing chat**

1. Right-click on a chat in the sidebar.
2. Select Move to group.
3. Choose the Chat Group you want to move it to.
4. The chat now belongs to that group.

**Method 2: Create a new chat in a group**

1. Open the Chat Group.
2. Select Start a new chat.
3. Have your conversation. The chat automatically belongs to this group.

### **Connect Knowledge Bases to a Chat Group**

Once you have a Chat Group with conversations, you can connect Knowledge Bases to give all chats in the group access to that knowledge.

1. Open the Chat Group.
2. In the right panel, select Group knowledge.
3. Select + Add knowledge base.
4. Choose the Knowledge Base(s) you want to connect.
5. Select Connect.

Now every chat in this group can reference the connected Knowledge Bases automatically.

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FVIjl6k0ptJSwtmWgMlno%2Fimage.webp?alt=media&amp;token=e4fb5e90-674c-4a75-a93d-af07feea3d6f" alt=""><figcaption></figcaption></figure>

### How Knowledge Bases and Chat Groups work together <a href="#how-knowledge-bases-and-chat-groups-work-together" id="how-knowledge-bases-and-chat-groups-work-together"></a>

**When you connect a Knowledge Base to a Chat Group:**

* All chats in the group have access to that Knowledge Base by default
* When you move a chat to a different group, it adopts the new group's Knowledge Bases
* Individual chats can still have their own attached files in addition to group-level knowledge
* You can connect unlimited Knowledge Bases to a single Chat Group

This creates a flexible knowledge inheritance system where knowledge scales across the workspace instead of being locked inside individual conversations.

* Storage limits
* Each Knowledge Base can now hold up to 500 MB of files, giving your AI enough depth to reference extensive company knowledge.
* Manage a Chat Group
* Reorder chats in a group
* Drag and drop chats within the group to reorder them.
* Rename a group
* Right-click on the group name and select Rename.
* Remove a chat from a group

Right-click on a chat and select Move to group → choose a different group or select No group to remove it.

### **Who can use Knowledge Bases and Chat Groups?**

Individual users can create Chat Groups for personal organization

### FAQ <a href="#faq" id="faq"></a>

**Can a chat belong to multiple groups?** No. Each chat belongs to one Chat Group. If you move a chat to a different group, it leaves the original group and joins the new one.

**What happens to a chat's knowledge if I move it to a different group?** When you move a chat to a different group, it drops the source group's Knowledge Bases and adopts the target group's Knowledge Bases. Any individual files attached to that specific chat remain.

**Can I connect multiple Knowledge Bases to a single Chat Group?** Yes. You can connect unlimited Knowledge Bases to a Chat Group. All chats in the group inherit access to all connected Knowledge Bases.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.nexos.ai/workspace/chat-groups.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
