Adding team members to an app

Each Bitrise app is owned by a Workspace - but this doesn't mean that all members belonging to that Workspace have access to a given app. In order to be able to collaborate on an app, users must be part of the app's team.

An app's team consists of all users invited to work on an app. There are two ways to add users to an app's team:

  • Adding one of the groups from the Workspace that owns the app.

  • Adding outside contributors.

Adding an outside contributor to an app team

An outside contributor is a user who is a part of an app's team but isn't a member of the Workspace that owns the app.

Admins and owners only

You need to be the an admin on the app's team or one of the owners of the Workspace that owns the app to be able to add new team members to an app.

  1. Go to the Team tab on your application’s page.

  2. Click Add member of group.

  3. In the Add contributors to this app section, type their email address.

    If they are not registered on Bitrise we will send out an invitation email for them.

  4. Before granting access to a new user, select their role.

  5. Click Grant access.

Adding Workspace groups to an app team

Workspaces consist of groups: the groups contain all users who belong to the Workspace. To assign users from a Workspace to a certain app, the most convenient way is to assign their group to the app's team.

Example 1. An app team consisting of Workspace groups

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 Groups menu of the Workspace's profile settings page.

  • You can assign it on the Teams tab of the app.

Assigning a group from the Groups menu

  1. Sign in with an account that is an owner of the Workspace and open its profile page.

  2. Go to your Workspace’s profile page: click Switch Profile on the top left corner and select the Workspace you need.

    Managing the apps of Workspaces
  3. On the left, select Groups from the menu options.

  4. Choose the group you wish to assign, and click the dropdown menu indicated by the symbol.

  5. Click Assign group to apps.

    Managing the apps of Workspaces
  6. Find the app(s) you need and select the appropriate role for the group. You can check out the role cheatsheet on any app’s Team tab.

    Managing the apps of Workspaces

Assigning a group from the Team tab

  1. Go to the app’s page on bitrise.io.

  2. Select the Team tab.

  3. Find the Add a group from OrgName menu.

    Managing the apps of Workspaces
  4. Find the group you wish to add and click the + symbol.

  5. Select the role for the group.

    For rights of roles, check out the Role Cheatsheet!