> For the complete documentation index, see [llms.txt](https://wiki.secrets.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.secrets.ai/get-started/group-chats.md).

# Group Chats

Bring multiple AI companions together in a single conversation.

### What are Group Chats?

Group chats allow you to create dynamic scenarios, parties, or collaborative roleplays with up to 3 companions at once.

### Creating a Group Chat

Group Chats are an **Ultimate Tier** feature.

1. **Open the New Chat Menu:** Click the **+** (Plus) button in the chat list.
2. **Select "Group Chat":** Switch the tab at the top of the modal from "Private" to "Group Chat".
3. **Choose Companions:** Select **at least 2** companions to join the group.
   * You can mix and match main companions and your custom characters.
   * Use the filters to find specific companions by type or gender.
4. **Name Your Group:** (Optional) Give your group a custom name like "Movie Night", "Beach Party", or "Study Group."
5. **Start Chatting:** Click **Start Group Chat** to begin.

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FBt2Mkd0Gkga1p85kZEUo%2Fimage.png?alt=media&amp;token=8f512511-0922-4dea-9993-bf71e9a9261f" alt="" width="375"><figcaption></figcaption></figure>

### How Group Chats Work

* **Dynamic Responses:** Companions will respond to you and to each other based on the conversation context.
* **Sender Identification:** Each message will clearly show which companion sent it.
* **Header:** The chat header displays stacked avatars of all participants. Clicking it shows the full member list.
* **Safety checks:** If one companion's reply is stopped by a safety check, you'll see a **Message not sent** notice for that companion. The other companions still reply. See [Safety checks](/get-started/chat-features.md#safety-checks).

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FeAN3yGLvT0uvhS7hmWM7%2Fimage.png?alt=media&amp;token=d317624a-86fd-44da-87c6-85bfcd6d6fc0" alt="" width="241"><figcaption></figcaption></figure>

### Chat mode and thinking level

Choose the group's mode from the selector in the chat header. In **S3**, **S4**, or **S5**, open the group's settings to choose a **Thinking level**, then select **Save** or **Save Changes**. The level applies to the companions' text replies in that conversation.

New groups inherit your account's default thinking level. Changing the account default does not update existing groups. See [Chat Modes & Thinking Levels](/get-started/chat-modes-and-thinking-levels.md) for the available levels and their effect on response time.

### Chat time

Open the group's **Chat Settings → Chat time** to choose **Live time**, **No time**, or **Fixed time**, then select **Save** or **Save Changes**. The setting applies to all companions in the group, including during voice calls. See [Chat Time](/get-started/chat-time.md) for fixed scene clocks and how changes affect earlier messages.

### Image Generation in Group Chats

Group chats now support **image generation**! Use the instant image button to generate a group photo featuring your companions based on the conversation context. The AI automatically picks which companions appear in the image.

{% hint style="info" %}
**Persona photos are available to all Ultimate subscribers.** A group chat photo can include your persona when the scene calls for it. Choose a persona with a saved photo in the group's **Active persona** selector. The chat uses that selection; **None** does not fall back to your account default. See [Persona Photos](/create/persona-photos.md#include-yourself-in-chat-photos).
{% endhint %}

Use **Chat Settings → Lock appearance** to keep reference looks consistent or allow appearance changes established in the group story. Save the setting before requesting another photo. See [Chat Photos](/create/chat-photos.md#keep-a-consistent-appearance-or-allow-story-changes).

For full details on group image generation, see [Image Generation](/create/image-generation.md#group-image-generation).

### Voice Calls in Group Chats

{% hint style="info" %}
Group voice calls are currently **in beta**. Feedback is appreciated!
{% endhint %}

You can now start **voice calls** in group chats and talk to all your companions at once. Each companion takes turns responding, creating a natural multi-companion conversation.

For full details, see [Audio Calls](/create/audio-calls.md#group-voice-calls).

### Memory in Group Chats

Group chats support **per-companion memory**, giving you fine-grained control over what each companion remembers.

#### Lorebooks

Lorebooks are included with **PREMIUM and ULTIMATE**. Using them in **Group Chats requires ULTIMATE**; PREMIUM subscribers can use lorebooks in private chats.

Each companion has their own book selection. Choose a companion's existing book to carry that continuity into the group, or a separate book for a separate storyline. Edits affect every chat using that particular book; they do not copy entries into other companions' books.

While creating a group, you can also choose **Universe Book** for each member. A [Universe](/lorebooks/universe-books.md) provides reusable starting material. Even if both members choose the same Universe, each gets a separate companion book, and later changes to the original Universe do not update either copy.

When viewing lorebooks from a group, select the companion's tab to open their book. Members can use lorebooks or the older memory system independently. See [Managing Books Across Chats](/lorebooks/managing-books.md#books-in-group-chats) and [Upgrading a Group Chat](/lorebooks/upgrading-memory.md#upgrade-a-group-chat) for the full walkthroughs.

#### Legacy memory scopes

The settings below apply to members still using the older memory system. Each has their own memory scope:

* **Private Memory (default):** Memories created within the group chat are specific to that conversation. Things you tell a companion in the group will not affect your private 1-on-1 chats with them, and vice versa.
* **Shared Memory Group:** You can link a companion to an existing Memory Group from your 1-on-1 chats. That companion will then share memories across any chat - private or group - that uses the same Memory Group.

#### Setting Up Legacy Memory Groups

**When creating a group chat:**

1. After selecting your companions, you'll see memory groups.
2. For each companion you have the option to use an existing **Memory Group**.
3. You can also create a new Memory Group directly from this screen.

**When editing an existing group chat:**

* Companions that don't have a Memory Group assigned yet can be given one.
* Once a Memory Group is assigned to a companion, it is **locked** and cannot be changed.

#### Example

You have a Memory Group called "Main Story" that your 1-on-1 chat with Zoey uses. You create a group chat with Zoey and Molly, and assign Zoey to the "Main Story" group while leaving Molly on private memory. Now Zoey remembers everything from your main storyline in the group chat, while Molly starts fresh with no prior context.

#### Key Points for Legacy Memory

* Each companion in a group chat can have a **different** memory scope.
* Private memory keeps the group chat fully isolated - no bleed-over with your other chats.
* Shared Memory Groups let you carry a companion's knowledge into group scenarios.
* Memory Groups are set per companion, not for the whole group chat.

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2FULnkglDY95mFvkS1VrMq%2Fimage.png?alt=media&amp;token=6b318c30-5476-44e5-a1e9-b31a367cd870" alt="" width="375"><figcaption></figcaption></figure>

### Frequently Asked Questions

**Q: How many companions can I add?** The maximum number of members depends on your subscription tier, up to a limit of 3 companions per group.

**Q: Can I add or remove companions later?** Currently, group members are set when the chat is created. To change members, you'll need to start a new group chat.

**Q: Do group chats cost more moments?** Group chats consume your message limits or moments just like regular chats.

**Q: Can I use Custom Characters in groups?** Yes! You can include any Custom Character you have created or have access to.