Skip to main content

​
Overview

User groups let administrators organize workspace members into logical collections for permission management. Users can belong to multiple groups, and every group can contain multiple users. Group membership is inherited during invitation and can be updated at any time.
Groups list with Create Group button

​
User Groups Functionality

  1. Grouping Users: Organize users into collections that reflect their team, function, or access needs.
  2. Multiple Users per Group: A single group can contain any number of members.
  3. Multiple Groups per User: A user can belong to any number of groups.
  4. Permissions Inheritance: Users inherit permissions assigned to each of their groups.
  5. Custom Groups: Create your own groups alongside the built-in system groups. System groups (for example, the everyone group) cannot be deleted.
  1. Sign in to your PipesHub account with administrator credentials
  2. Open the user menu and click Workspace Settings
  3. In the workspace sidebar, expand the People section and select Groups
The page shows a table of all groups with columns for Name, Description, Users (member count), Created By, and Created On. Use the search field to find groups by name, the Created On filter to narrow by date, and click any row to open the group’s detail panel on the right.

​
Managing Groups

​
Creating a Group

  1. From the Groups page, click Create Group in the top-right corner
  2. The Create Group panel opens on the right
  3. Enter the Group Name (required) — for example, Data Engineering
  4. (Optional) Enter a Group Description that explains the group’s purpose
  5. (Optional) Under Add Users, search for and select members to add to the group on creation
  6. Click Create Group
Create Group side panel
Group names must be unique within your organization. A name another group already has, even one someone else created a moment earlier, is refused with Failed to create group and the detail Group already exists; choose a different name. A rename follows the same rule and shows Failed to update group with the same detail. A deleted group’s name can be reused.
Access Permissions for groups are shown as Coming Soon in the current UI — group membership itself controls access today.

​
Adding Users to Groups

Option 1 — During User Invitation While inviting a user from the Users page, use the Add to a User Group field in the invite panel to assign one or more groups. New users inherit permissions from the groups you select.
Assigning groups during user invitation
Option 2 — From the Group Detail Panel
  1. Navigate to the Groups page and click the group’s row to open its detail panel
  2. Click Edit Group
  3. Under Add Users, search and select the members to add
  4. Click Save Edits
Adding existing users to a group from the group detail panel

​
Removing Users from a Group

  1. Open the group’s detail panel from the Groups page
  2. Click Edit Group
  3. In the Users list, click Remove next to each user you want to remove. Click Undo to cancel a pending removal before saving
  4. Click Save Edits to apply the changes

​
Editing a Group’s Name or Description

  1. Open the group’s detail panel
  2. Click Edit Group
  3. Update the Group Name or Group Description
  4. Click Save Edits

​
Deleting a Group

  1. Open the group’s detail panel
  2. Click Delete Group at the bottom of the panel, or use the Delete option in the row actions menu (⋯) on the Groups page
  3. Confirm the action
Deleting a group is irreversible. Members of the group are not deleted, but they lose any permissions that were inherited from it. System groups cannot be deleted.

​
Duplicate Group Names from Older Versions

If an older version left two active groups in one organization with the same name, PipesHub logs an error each time the server starts, and keeps the database safeguard off. The safeguard is a unique index that refuses a duplicate name even when two requests arrive at the same moment. Older versions allowed duplicates in two ways: a rename didn’t check the new name, and two create requests at the same moment could both be saved. The error reads:
The log entry’s duplicates field lists each clash: the organization ID (orgId), the shared name, and the IDs of the groups that use it (groupIds). Nothing is renamed or deleted automatically. Creating or renaming a group still refuses a duplicate name; only requests arriving at the same moment can get past while the safeguard is off. To fix it:
  1. Rename all but one group in each listed set, so every active group in the organization has its own name.
  2. Restart PipesHub.
On the next start, the check finds no duplicates, turns the safeguard on, and stops logging the error.

​
Conclusion

User groups simplify workspace management by letting you organize members around teams, functions, or access needs. Assign users to groups during invitation or from the group detail panel, and use the built-in filters on the Users page to find everyone in a specific group quickly.