# Group Chats

### 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="/files/pTVdmbfpRWjjZsPOwGgu" 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.

<figure><img src="/files/0apuAbiwbjXJdcZLJBKX" alt="" width="241"><figcaption></figcaption></figure>

### 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.

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.

#### How It Works

Each companion in a group chat has their own memory scope. When creating or editing a group chat, you can configure memory individually for every member:

* **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 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

* 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="/files/47aaRB5pDppkusSFqIcs" 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.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.secrets.ai/get-started/group-chats.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.