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

# Group Conversations

> Create BeatPass group chats for collaborations and shared discussions.

Group conversations let you message multiple BeatPass users inside the same thread. They are useful for beat collaborations, playlist planning, and shared production discussions.

***

## Creating a Group Conversation

1. Click the **message icon** in the navigation bar
2. Click **New**
3. Search for and select **at least 2 other users**
4. Continue selecting additional users as needed
5. Type your first message
6. Press **Enter** or click the send button

The group conversation is created automatically when you send your first message.

<Note>
  The current web UI requires **you plus at least 2 other users** for a group chat.
</Note>

***

## Participant Limits and Naming

| Topic                                  | Current behavior                                                        |
| -------------------------------------- | ----------------------------------------------------------------------- |
| **Minimum participants**               | `3` total people including you                                          |
| **Maximum participants in the web UI** | `10` total selected people                                              |
| **Group title**                        | BeatPass creates the conversation title automatically from participants |
| **Custom naming UI**                   | Not currently exposed in the web player                                 |

***

## How Group Conversations Work

Sending messages in a group works the same as direct messages:

1. Open the group conversation
2. Type your message in the input field
3. Send it with **Enter** or the send button

Group conversations also support:

* Typing indicators
* Seen states
* Unread badges
* Failed-send retry
* Automatic updates while the chat is open

***

## Group vs. Direct Messages

| Feature          | Direct Message           | Group Conversation               |
| ---------------- | ------------------------ | -------------------------------- |
| **Participants** | 2 total                  | 3 or more total                  |
| **Title**        | Other participant's name | Auto-generated group title       |
| **Best for**     | Private one-on-one chat  | Shared collaboration or planning |

***

## Managing Group Participants

The current web messaging UI does **not** expose:

* add-participant controls
* remove-participant controls
* custom group renaming

If you need a different participant set, start a new group conversation.

***

## Best Practices

* Keep group membership focused so unread counts stay manageable
* Use direct messages for side conversations that do not need the whole group
* Start a fresh group if the participant list changes materially

***

## Notifications in Groups

Group conversations follow your standard message notification settings. You will be notified about new activity through the channels you enabled for messaging.

<Warning>
  Active groups can generate a lot of notification noise. Review your message notification channels if you are in several busy chats.
</Warning>

***

## Related Topics

<CardGroup cols={2}>
  <Card title="Direct Messages" icon="comment" href="/help/messaging/direct-messages">
    Send private one-on-one messages instead.
  </Card>

  <Card title="Managing Conversations" icon="folder" href="/help/messaging/managing-conversations">
    Learn how to hide or manage chats after they are created.
  </Card>
</CardGroup>

<Snippet file="sections/need-help.mdx" />