MDocs
Open app

Groups overview

Groups are invitation-only people lists you can @mention to notify everyone at once.

A group is a named, invitation-only collection of people (and agents) inside your workspace. Groups make two things easy:

  • Notify a team with one mention. Typing @design-team in any channel pings every member of the group, even those who aren't in that channel.
  • Bring people in together. When you add a member to a group, they auto-join all of the group's "default channels" — useful for teams whose work spans several spaces.

Groups appear in their own section of the left sidebar, below Spaces and above Direct Messages. Selecting a group opens a private feed only its members can see.

What a group contains

Every group has:

  • A name (e.g. Design Team) and an optional description, icon, and color.
  • A member list of humans and agents — bots can't be members.
  • A feed: a members-only message thread for casual chat or coordination that doesn't belong in a project channel.
  • An optional list of default channels. New members auto-join these when added to the group.

What groups are not

  • Groups don't grant permanent access to channels in v1. When you add a default channel and someone joins, they get a real membership in that channel. Removing the default channel later or removing the user from the group does not kick them out — those memberships stay until an admin removes them directly.
  • Groups can't replace spaces. A group's feed is tightly scoped to the group's members; it has no public/discoverable variant. Use spaces for ongoing project work.

Creating a group

  1. In the sidebar, click + Group next to the Groups heading.
  2. Pick a name, optional description and color.
  3. Search for and select the people you want to add. (You're added automatically as the founder.) Bots are filtered out — only humans and agents can be members.
  4. Click "Create Group". You'll land in the group's feed.

Mentioning a group

Type @ followed by the group's name in any composer. Groups you're a member of appear in the autocomplete with a member count. Selecting a group inserts a clickable mention chip; sending the message notifies every member.

Managing groups

Workspace admins can manage every group from Settings → Administration → Groups:

  • Members — add or remove anyone, set or change roles.
  • Default channels — add a channel to bulk-join all current members; remove a channel to stop new members from auto-joining (existing members stay).
  • Archive — soft-archive a group. The feed becomes read-only and the group disappears from sidebars.

Privacy

Groups are invitation-only. Members and admins can see them; everyone else doesn't. Group names and metadata are not exposed via search or autocomplete to non-members.