# Groups overview

## What is a Group?

Groups are a collection of people in your workspace that organize people by team, department, or project, **allowing you to** **send threads to specific audiences**.

Groups can be thought of as the improved replacement to a channel. Groups still accomplish the goal of reaching a specific audience of people, but since threads are not specifically locked into group, you do not need to create groups for every specific combination of people.

Overall, there should be far fewer groups compared to channels in a channel-based chat system.

#### Recommended use cases for groups

* **Departments:** We recommend that admins set up a group for each department
* **Teams:** Teams can create their own groups as needed
* **Projects:** For a multi-quarter project, a group might be helpful, but shorter term projects can be discussed in a thread addressed to the relevant groups and individuals.

{% hint style="success" %}
Since one thread can be sent to multiple groups and individuals simultaneously, there’s no need to create overly specific groups for every situation.
{% endhint %}

## Ways to interact with a Group

### **Private Group Chat**

Every group has a [private chat](https://docs.glue.ai/conversations/group-chat) that can be used for quick questions or casual conversations that don't require a thread. You can always turn any message into a new thread after the fact.

### **Threads for Groups**

Users can start threads with one or more groups to keep the right people in the loop and keep your conversations organized. The thread will show up in the Groups’ chat and thread list for each Group.

## Group Features

Each group has its own hub to interact with the other group members, catch up on current discussions and manage group settings.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2F56UKDSiWZe2mIL1vZWMf%2Fimage.png?alt=media&#x26;token=fab3a895-5b0f-4f26-ae39-5d06b148b3ff" alt=""><figcaption></figcaption></figure>

* **Chat:** The private group chat stream containing individual messages as well as threads
* **Threads:** List view of all threads shared in a group — with thread names and a preview to quickly scan for a relevant thread
* **Feed:** Social feed of all threads shared with a group with expanded preview if you want to catch up on recent posts
* **Shared:** View of files, media and links shared in the group

{% hint style="info" %}
Remember, a thread can include multiple recipient groups, so if you belong to several groups added to a thread, you'll see that thread in each group's thread list.
{% endhint %}

## Accessing and creating Groups

### Accessing groups you belong to

You can access the groups you belong to in two main ways: through your **Inbox** or the **Groups** tab.

### Creating a new group

You can also **create groups in these same spaces**, as well as from the create (+) menu.&#x20;

<details>

<summary>Group Creation Flow</summary>

Here's what you can do when you create a new group:

* Choose a group name and emoji
* Add workspace members or external guests to the group
* Make other members an admin of the group (the group creator is automatically made an admin of the group)
* Choose [group access settings](#group-access-settings) - open or closed

<img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2Fd0lde3rsP43lhLMwetzy%2FCleanShot%202024-12-04%20at%2015.42.34%402x.png?alt=media&#x26;token=2c72dae9-4769-46ae-ade0-ec290b2debb1" alt="" data-size="original">

<img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FxF3JjLqWb1WEbxzTUY26%2FCleanShot%202024-12-04%20at%2015.43.21%402x.png?alt=media&#x26;token=247b899e-fc95-43c0-aa6f-863ceffa86e8" alt="" data-size="original">

</details>

{% hint style="info" %}
Anyone in the workspace can create a group. We recommend being thoughtful before creating a new group though. Review which groups exist and consider if a thread will work instead for a short term conversation.
{% endhint %}

{% tabs %}
{% tab title="Groups in your Inbox" %}
Recently active (within the last week) and starred groups from any workspace you belong to appear in your **Inbox**. When there are unread messages in a group, the group name will be bolded. If a thread in a group is an [important thread](https://docs.glue.ai/inbox/inbox#what-makes-a-thread-important) to you, it will also show up in your thread inbox.

To create a new group from the Inbox, click on the Groups header and select the option from the dropdown.

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>Starred and Recently Active Groups show up in the Inbox</td><td></td></tr><tr><td></td><td><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2F28CuA9mSEbTSMSN5rTMC%2FScreenshot%202024-10-17%20at%202.27.37%E2%80%AFPM.png?alt=media&#x26;token=c4503a04-2da5-460c-a9db-2b366a55f634" alt="" data-size="original"></td></tr></tbody></table>

{% hint style="info" %}
If you want a Group to always appear in your inbox, you can **Star ⭐️** it to keep it in the "Starred" section of your inbox.
{% endhint %}
{% endtab %}

{% tab title="Groups Tab" %}
In the **Groups** tab, you’ll find all the groups you belong to per workspace. If you belong to multiple workspaces or external groups, you will see them all listed here. You can also access your Workspace's [Group Directory](https://docs.glue.ai/groups/group-directory).

To create a new group, either click "Add groups" at the bottom of your group list or select "Create group" by clicking the workspace name at the top.

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>See all Groups in your Workspaces and External Groups</td><td></td></tr><tr><td>Create a Group from clicking on the Workspace name or "+ Add groups"</td><td></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

### Browse all the groups in your workspace

You can see all the groups in your workspace by accessing your [workspace details](https://docs.glue.ai/workspaces/workspace-settings) or the [Group Directory](https://docs.glue.ai/groups/group-directory). You can browse all group names, but currently you cannot view a group's page without joining it first. A group might be open to join right away, or require you to request access first if it's a closed group. See [group access settings](#group-access-settings) for more details.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FK08cA582HqfDvvxb354Q%2Fimage.png?alt=media&#x26;token=f6e80992-8620-42f5-9b5e-4b492d3a5c1a" alt="Browse all groups in your company in the Group Directory"><figcaption><p>Browse all groups in your company in the Group Directory</p></figcaption></figure>

## Leaving a group

#### For users who want to leave a group

1. Open the group in your app.
2. You can leave the group in two ways:
   1. Click the ellipsis icon on the right hand side and open the group menu. The last option is to "leave group."&#x20;
   2. Click on the name of the group at the top, and go to the Settings tab. Select "Leave Group."
3. A pop up will come up asking you to confirm that you want to leave the group. Select "Leave group" again.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FEgsvkkktLknui0S5UcZK%2FCleanShot%202025-02-27%20at%2010.46.38%402x.png?alt=media&#x26;token=ab104830-d557-4d31-a99d-cfb63d3ab8f7" alt="" width="563"><figcaption><p>Click the ellipsis and find the "leave group" option</p></figcaption></figure>

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FdzRe7E5A05TL6Hdq9YAm%2FCleanShot%202025-02-27%20at%2010.46.50%402x.png?alt=media&#x26;token=2709b15f-75f2-4d16-9ed9-2046043b4021" alt="" width="375"><figcaption><p>Alternatively, click the name of the group and go to the settings tab.</p></figcaption></figure>

#### For admins who want to leave a group

1. Open the group in your app.
2. Click on the name of the group at the top, or click the ellipsis and select "Group settings." Either way will open the group menu.
3. Navigate to the Settings tab (if opened from clicking on the group name).
4. Scroll to the bottom and select "Leave group."
5. A pop up will come up asking you to confirm that you want to leave the group. Select "Leave group" again.

<figure><img src="https://22865677-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yStw8wuIeWBdGOh81bd%2Fuploads%2FF0af2L4zy37IGXUEIirb%2FCleanShot%202025-02-27%20at%2010.50.04%402x.png?alt=media&#x26;token=7dbea509-85e4-4252-ae94-b6495e881546" alt="" width="375"><figcaption><p>Leave the group from the Group Settings menu.</p></figcaption></figure>
