Manage user groups

How to get there: Go to Users & companies → User groups.

Use a group to give selected customers access to a private board, such as a beta roadmap or a client feedback board.

What are user groups?

User groups are named collections of users. Use them to control board access: a board with visibility set to "Selected user groups" is only visible to members of the selected groups (and admins).

Each group has:

  • A name
  • An optional description
  • A list of members

User groups vs. user segments

User groups and user segments are different features:

Feature User Groups User Segments
Purpose Board access control Analytics and filtering
Assignment Assigned by an admin, import, SSO or API Auto-calculated from user data
Examples "Beta Testers", "Enterprise" "High MRR", "Trial Users"
Controls what a user sees? Yes (which boards) No (analysis only)

See User Segments for segment details.

Creating a user group

  1. Go to Users & companies → User groups.
  2. Click Add new group.
  3. Enter a Name (2-60 characters, unique within the portal).
  4. Optionally enter a Description.
  5. Click Save.

The group appears in the list with its ID and any users you have added.

Adding users to a group

From the group

  1. Go to Users & companies → User groups.
  2. Click Show Users on the group.
  3. In the "Add User" search box, start typing a name or email.
  4. Select the user from the results.
  5. Click Add User.

Repeat for each user. Users must already exist in your portal, either because they signed up, were invited, or were imported.

From a user's profile

  1. Go to Users & companies in the top-level sidebar (/admin/userlist).
  2. Click the user you want to manage.
  3. In the user detail panel, find the Groups row and click edit.
  4. Pick a group from the dropdown and click Add.
  5. Click Save.

Removing users from a group

  1. Go to Users & companies → User groups.
  2. Click Show Users on the group.
  3. Click Remove next to the user.

Or from the user profile in Users & companies → click the user → edit the Groups row → remove the group tag → Save.

Assign groups through an integration or import

For many users, import users with group membership, or pass groups through SSO. Your developer can also manage membership through the API. Follow the field format and update behavior for that route.

Group membership does not automatically follow segment rules. For example, creating a "High MRR" segment does not grant its members access to a private board.

Using groups for board access control

Board visibility is set per board and has exactly four options:

  • Public: anyone can see the board, including logged-out visitors (subject to your portal's public/private setting).
  • Members and Admins: any logged-in user in this portal (any Member or Admin).
  • Admins only: only Admins.
  • Selected user groups: only Admins plus users who belong to at least one of the selected groups.

To restrict a board to specific groups:

  1. Go to Settings → Boards.
  2. Click the board you want to restrict.
  3. In Access & visibility → Who can access this board?, choose Selected user groups.
  4. Select one or more groups from the multiselect.
  5. Save the board.

Users see the board if they are an Admin, or if they are a member of any of the selected groups. Users outside those groups do not see the board in the portal at all.

Group access control operates at the board level. There is no per-post group visibility.

Troubleshooting

Issue: user can't see a group-restricted board

  • Confirm the user is logged in (group visibility only applies to authenticated users).
  • Verify the user is in one of the board's allowed groups: Users & companies → open the user → Groups row.
  • Verify the board is set to Selected user groups and lists at least one group the user is in: Settings → Boards → the board → Access & visibility → Who can access this board?.
  • If the portal is set to private (Settings → Authentication), the user must also have an account.

Issue: adding a user does nothing

  • The user has to already exist in your portal. If they haven't signed up or been invited yet, invite them first from Users & companies → Add User, then come back and add them to the group.

Access control:

User management:

Board setup: