Managing the apps of organizations

Organizations can own several apps, with different (or the same, if that’s what you need) groups working on different apps. Apps can be transferred between private accounts and organization accounts any time, quickly and easily.

Adding new apps to an organization ⚓

A new app can be added directly to an organization. You can do this either from the organization’s Account settings page or from the Dashboard of an account that is a member of the organization.

Get to the Create New App page.

There are three options to get there:
- On the top menu bar, find the + symbol and click it, then click the Add App option.
- Open the Dashboard on bitrise.io, open the dropdown menu above your app list and select your organization. Click the + Add new app button.
- Open the Account settings page of your organization, and click the Apps option on the menu on the left. Click the Add new app button.
On Create New App page, make sure that the organization account is selected in the dropdown menu.
Proceed with adding a new app as usual! It will be owned by the organization.

Transferring apps to an organization ⚓

When you create an organization, you get a prompt for transferring apps from the account that you are logged in with to the organization. However, if you skipped that step, you can do it on our website at any time you wish.

You have two options to transfer app ownership.

Several apps can be transferred at the same time from the organization profile.
Any given app can be transferred from the app’s Team tab.

App ownership can be transferred from an organization to another account on the app’s Team tab. Only organization owners can do this.

Transferring apps from the organization profile ⚓

Sign in with an account that is a member of the organization and open the account’s profile page.
Go to your organization’s profile page: click Switch Profile on the top left corner and select the organization you need.
On the left, select Apps from the menu options.
Click the Transfer apps button.
Find the apps you wish to transfer and toggle the switch on the right. Once you’re done, click Done.

Transferring an app from the Team tab ⚓

It can happen that you need to transfer an application on Bitrise to another user. This can be done in a few seconds by following these quick steps:

Login with the current owner of the app.
Open the app’s page and go to the Team tab.
Make sure the new owner of the app is in the team or add her/him if you need to.
Click the Transfer ownership button on the top right.

For transferring the ownership, select the new user to transfer the app to:

The new user can either be another private account or an organization.

Assigning groups to apps ⚓

There are two separate ways to assign one or more groups to an app that is owned by an organization.

Assign a group from the Groups menu of the organization’s profile page. This way you can add a group to multiple apps simultaneously. Only organization owners can do this!
Assign a group from the Team tab of the app. If the groups you need already exist and you only need to assign groups to a single app, this method works perfectly. Organization owners and accounts that have an admin role on the app’s team can do this.

Assigning a group from the `Groups` menu ⚓

Sign in with an account that is an owner of the organization and open its profile page.
Go to your organization’s profile page: click Switch Profile on the top left corner and select the organization you need.
On the left, select Groups from the menu options.
Choose the group you wish to assign, and click the dropdown menu indicated by the ... symbol.
Click Assign group to apps.
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.

Assigning a group from the `Team` tab. ⚓

Go to the app’s page on bitrise.io.
Select the Team tab.
Find the Add a group from <OrgName> menu.
Find the group you wish to add and click the + symbol.
Select the role for the group.

For rights of roles, check out the Role Cheatsheet!

If there are no groups you can assign to the app in this menu, you will see a grey box telling you No groups to show. Clicking the link will take you to your organization’s Groups page where you can create the groups you need, including removing the group from the app.

Screenshot

From the Team tab you can also access all the functions to manage groups. You have to click MANAGE GROUP to the right of the group members, and click the action you need in the pop-up window.

Adding contributors to an app ⚓

You can add contributors to any application if you have Admin or Owner right to the app. There are two types of contributors at Bitrise:

Contributors are organization members who can be individually added to an app.
Outside contributors are not part of an organization but can be individually invited to an app of an organization.

This means that if you wish to add an organization member to an app of the organization, all you have to do is add the username/email address of the member under Add contributors to this app on the Team page of the app.

Adding an outside contributor requires enabling the Allow Outside Contributors switch on the organizations’ People tab. Let’s see the details!

Go to your organization’s page on bitrise.io.
On the left menu bar, select People.
Toggle the Allow Outside Contributors switch to the right. Please note that without enabling this function here, you will not be able to add an outside contributor to your app on the Team tab!
On the left menu bar, select Apps.
Search for or click the app you want to add outside contributors to. (In our example, it is the android-multiple-test-results-sample app.)

The Builds page appears.
Select the Team tab.
Find the Add contributors to this app menu.
Enter a username or an email address.

The email address you enter - if you choose that option - does not have to be associated with an existing Bitrise account.
Select a role for the user and then click Grant Access.

For rights of roles, check out the Role Cheatsheet linked above Grant Access.

Bitrise sends an invitation email to the contributor’s email address with a link to view the app.

If all went well, you should see the invited outside contributor at the People tab of your organization.

Removing outside contributors

You can remove the outside contributor on the People tab by clicking the red x. Please note that you have to remove all outside contributors if you want to disable the Outside Contributor toggle.

Removing a group from an app ⚓

Go to the app’s page on bitrise.io.
Select the Team tab.
Find the group you wish to remove, and click the MANAGE GROUP option next to one of the names of the group members.
Click REMOVE FROM APP. Click Yes in the pop-up window.