Creating and editing custom roles

Create custom roles scoped to either a workspace or a Bitrise CI project. Custom roles are available on Enterprise plans.

Creating custom roles

1. In the Bitrise app, open your workspace and go to Workspace settings > Collaboration > Roles.
2. Select Create role.
3. On the Details step, name the role (40 characters max), add an optional description, and choose a scope.
4. On the Permissions step, check off what the role can do, category by category.
5. Save, then assign it to anyone on your team.

See Permissions reference for what each permission on the Permissions step actually grants.

Editing custom roles

A workspace Owner or Manager can edit a custom role at any time. Members holding the role pick up the change immediately.

1. In the Bitrise app, open your workspace and go to Workspace settings > Collaboration > Roles.
2. Find the custom role and select its edit icon.
3. Rename the role, change its description, or adjust its permissions.
4. Save.

Removing custom roles

A workspace Owner or Manager can remove a custom role at any time.

1. In the Bitrise app, open your workspace and go to Workspace settings > Collaboration > Roles.

2. Find the custom role and select its remove icon.

3. If no one is currently assigned to the role, confirm the deletion.

   If the role is still assigned to one or more members or workspace groups, you must pick a Replacement role first: another custom role or a built-in system role with the same scope (Workspace or Bitrise CI). The Delete button stays disabled until you choose one.

4. Confirm the deletion.

Everyone assigned to the removed role, including members of any global access group, is moved to the replacement role you picked. No one is left without a role.