Slack User Groups: How to Create, Mention and Manage Them

A Slack user group is a named list of people with its own handle, such as @designers or @oncall. Mention the handle in any channel and everyone in the group gets a notification, without tagging each person. To create one on a paid plan, open Directories, then User groups, then Create user group. On the Free plan the User groups tab is not there at all, and by default only Workspace Owners and Admins can create groups on paid plans.

If you are looking for the button and cannot find it, the two usual reasons are the plan and an admin setting. We checked the Free-plan case in our own test workspace on October 4, 2026; the results are below.

What a Free Slack workspace shows

We opened our test workspace (Free plan, signed in as the Primary Owner) in the Slack web app and looked for user groups in three places.

Directories. The page has four tabs: People, Channels, External and Invitations. There is no User groups tab, so there is no Create user group button to click.

Admin settings. Under Settings & permissions, then Permissions, the User Groups row carries a PRO badge and the line "You do not have permission to change settings for User Groups", even for the Primary Owner. Expanding it shows two greyed boxes, "Create @admins for all Workspace Admins" and "Create @owners for all Workspace Owners", and a See Paid Plans button.

The API. usergroups.list returns an empty list, and usergroups.create fails with a plan error:

usergroups.list   -> {"ok": true, "usergroups": []}
usergroups.create -> An API error occurred: paid_teams_only

So on Free there is no way around it, from the app or from a script. The options are to mention people one by one, use @here or @channel inside one channel, or make a channel for the group.

How to create a user group on a paid plan

These are the steps in Slack's help article "Create and edit user groups". We could not click through them ourselves, because our test workspace is on Free.

• From the Home tab, click Directories.
• Open the User groups tab, then click Create user group.
• Choose a name and a handle. The handle is what people type after @.
• Optionally, set a purpose, pick default channels that members join (up to 100), or create a shared sidebar section. Click Next.
• Under Add members, search for and select people.
• Click Create Group.

On Business+ you can also create workspace user groups through SCIM provisioning from your identity provider. On Enterprise, Org Owners and Admins create org-level groups from Organization settings, People, Groups, and those can span several workspaces.

Why you do not see Create user group

• • Your workspace is on the Free plan. You will see no User groups tab in Directories, as in the screenshot above. An Owner has to upgrade. Tools that create groups through the API, such as the slack_usergroup resource in Terraform's Slack provider, need a paid workspace too.
• • An admin limited who can create groups. On paid plans, Workspace Owners and Admins create and edit groups by default, and they can open this to all members in the User Groups permission shown above. If you have no admin rights, ask an Owner or Admin to add the group or change that setting. The difference between the two roles is in Slack workspace Owner vs Admin.
• • You are a guest or in Slack Connect. Guests and people from other companies in Slack Connect channels cannot be added to your user groups and cannot mention them. See Slack Connect vs guest accounts.

Edit a user group, add members, or turn one off

• Add or remove members: open Directories, then User groups, click the group, click Edit Members, then Save.

• Change the name, handle or default channels: click the group, then the three dots, then Edit group details.

• Deactivate: the three dots, then Deactivate group. Nobody can mention the handle any more, but the group stays in the list with its members, so you can turn it back on later.

How to mention a user group

Type @ and the group's handle, for example @designers, then send. Members of the group who are in that channel get a mention notification. If some members are not in the channel, Slack may offer to invite them; the mention on its own adds nobody.

Apps and scripts mention a user group by its ID, which usergroups.list returns on a paid plan:

{
  "channel": "C0123456789",
  "text": "<!subteam^S0123456789> the release is ready for review"
}

Send that body to chat.postMessage. A plain @designers in API text is not turned into a mention.

User groups, channels and @here compared

Use a user group when the same people need to be reached in many channels, such as an on-call rotation. Use @here or @channel for one channel, and keep them rare; when each one is allowed is in Slack @everyone, @channel and @here. A group mention follows each member's own notification settings, so someone with paused notifications gets it when their pause ends, as described in Slack notifications not working.

FAQ

Can I name a group DM instead of making a user group?

No. A group DM has no name of its own; it shows the members' names. If you want a named place for the same people, create a private channel.

What are @admins and @owners in Slack?

They are user groups Slack can create for you, holding every Workspace Admin or every Workspace Owner. The option sits in the User Groups permission and is greyed out on Free.

Does deactivating a user group remove its members from channels?

No. Deactivating only stops the handle from being mentioned. Members stay in every channel they joined.

Can a user group include people from another workspace?

Only org-level groups on Enterprise can span workspaces. A workspace user group covers members of that one workspace.