- Home
- Workspaces
- Workspace groups
Workspace groups
Being the member of a Workspace's Team means being a member in one of the Workspace groups. Groups can be assigned to the apps that are owned by the Workspace.
Members of a Bitrise Workspace can be organized into Workspace groups. Groups allow flexible allocation of Workspace members between apps, simplifying the process of managing Workspaces that own multiple apps.
Workspace members can belong to multiple different groups. Groups can be assigned user roles on any app's team: each member of the group will have the group's role and the access rights that come with that role.
Difference between app teams and Workspace groups
App teams are handled per app, while Workspace groups are handled globally.
A Workspace group has no inherent roles on its own. You can assign groups to app teams and choose their role there, which means the same group can have different roles on different apps.
Creating groups for Workspaces
Owners only
Only Workspace owners can create groups for a Workspace.
-
Log in to Bitrise and hover over the left navigation bar.
-
Make sure you have the right Workspace selected.
-
Select Settings.
-
On the left, select Collaboration from the menu options.
-
Select the Groups tab.
-
Click the Create group button to bring up a dialogue box.
-
Enter a group name in the Enter a unique name field, and click Create.
Adding members to a Workspace group
You can add Workspace members to Workspace groups for more convenient management of Workspace members. Groups allow you to assign several members to app teams at the same time.
-
Log in to Bitrise and hover over the left navigation bar.
-
Make sure you have the right Workspace selected.
-
Select Settings.
-
On the left, select Collaboration from the menu options.
-
Select the Groups tab.
-
Find the group you need and click the 3 dots to the right of the group to bring up the group dropdown menu.
-
Click on the + Add member button.
-
Enter an email address or add an existing member to the group using the radio buttons in the dialogue box.
-
Select Invite a new member to the Workspace and enter an email address. Click Send Invite on the bottom to send the invitation.
-
Select Add an existing member and select one of the existing Workspace members from the dropdown menu. Click Add member on the bottom to add the team member to the group.
-
Adding Workspace groups to an app team
To assign users from a Workspace to a certain app, the most convenient way is to assign their group to the app's team. Assigning a Workspace group a user role means that all users in the group will have the same role on the app's team.
Let’s say the Workspace called TestSpace owns an app called TestApp. TestOrg has the following groups:
-
Group Alpha - they are assigned to TestApp with an Admin role. Members of this group can assign other groups to the app or add outside contributors, change app settings, manage roles and workflows.
-
Group Beta - they are assigned to TestApp with a Developer role. Members of this group can run builds, view build logs and view builds.
-
Group Gamma - they are assigned to TestApp with a Tester/QA role. They can only view builds.
There are two ways to assign Workspace groups to a Bitrise app's team:
-
You can assign it from the Team tab of the Workspace's profile settings page.
-
You can assign it on the App settings page of the app.
Assigning a group from the Workspace's profile settings page
-
Sign in with an account that is an owner of the Workspace and open its profile page by selecting the gear icon next to the Workspace's name.
-
On the left, select Team from the menu options and make sure you are on the Groups tab.
-
Choose the group you wish to assign, and click the dropdown menu indicated by the symbol.
-
Click Manage access to apps.
-
You can find the app(s) you need and select the appropriate role for the group, or you can select a role for the group for all current apps using the radio buttons.
Role cheatsheets
You can check out the role cheatsheet on the User roles on app teams, or find it on any app’s Team tab.
-
Click Save changes to finalize changes.
Assigning a group from the App settings page
-
Go to the app’s page on bitrise.io.
-
Click on App Settings.
-
On the left, select Team from the menu options.
-
Make sure that you are on the Groups tab.
-
Click on Grant access for group.
-
Find the group you wish to add and select the role for the group using the drop down menus.
-
Click Save.