Teams

Documentation Index

Fetch the complete documentation index at: https://docs.pipeshub.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

Teams let workspace members group themselves around a shared purpose — a project, a product area, or any collaboration unit. Unlike user groups (which administrators use to manage access), teams are available to every workspace member. A user can belong to any number of teams, and within each team members are assigned a role that determines what they can do with team resources.

​

Team Member Roles

Every member of a team has one of three roles:

​

Navigating to Teams

1. Sign in to your PipesHub account
2. Open the user menu and click Workspace Settings
3. In the workspace sidebar, expand the People section and select Teams

The page shows a table of all teams you can see, with columns for Name, Description, Members (count), Created By, and Created On. Use the search field to look up teams by name and the Created By and Created On filters to narrow the list. Clicking any row opens that team’s detail panel on the right.

​

Creating a Team

1. From the Teams page, click Create Team in the top-right corner
2. The Create Team panel opens on the right
3. Enter the Team Name (required) — for example, Product Engineering
4. (Optional) Enter a Team Description describing the team’s purpose
5. (Optional) Under Add Members, choose a Default Role (Reader, Writer, or Owner) for the members you’re about to select
6. Search for and select the users to add to the team
7. To change a specific member’s role after adding them, use the role dropdown next to their name in the Member Roles list. Click Apply to all to reset every selected member to the default role
8. Click Create Team

​

Viewing a Team

Click a team’s row on the Teams page — or choose View Team from the row actions menu (⋯) — to open the detail panel. The panel shows:

• The team’s Name and Description
• Created By — the user who created the team
• Members — a paginated list of members with their roles

​

Editing a Team

1. Open the team detail panel
2. Click Edit Team
3. Update any of the following, then click Save Edits:
   • Team Name or Team Description
   • Add Members — search and select additional users, with an optional default role and per-user role overrides
   • Member roles — change a current member’s role using the role dropdown next to their name
   • Remove members — click Remove next to a member; click Undo before saving to cancel the removal

Role changes, additions, and removals are applied together when you click Save Edits.

​

Deleting a Team

Teams can be deleted only by users who have permission to do so (typically team owners). If the option is available:

1. Open the team’s detail panel, or open the row actions menu (⋯) on the Teams page
2. Click Delete Team (or Delete from the row actions menu)
3. Confirm the action

​

Teams vs. User Groups

Use teams to organize the people doing work together, and user groups to control what members of the workspace can access.