What is an Organization on Bitrise?⚓
Organizations are used to seamlessly manage bigger teams and members inside a company. It is a place to gather all the people working on each of your company's apps and delegate them through creating different groups.
How do I create a new Organization?⚓
Just go to your account settings page,
scroll down and click on the green
New organization button at the bottom left.
A popup will appear to guide you through the process.
How do I add an app to an Organization?⚓
First, you have to be added to at least one
Group of the Organization.
Then, go to the Add new app page and select
the Organization in the dropdown at the top left.
You can change this throughout the process of adding the app, or after you finished adding the app, changing the owner is possible through transferring ownership.
How do I migrate/transfer my existing apps to an Organization?⚓
Once you've created an Organization, you can transfer any of your apps to it by going to
Team tab of the app you want to transfer, and clicking the Transfer ownership button at the top right.
What are "Owners" inside an Organization?⚓
Organizations can have more than one Owner. Owners can manage billing, delete apps and change the billing email, create, delete and assign groups to apps.
What can "Members" of an Organization do?⚓
Members are displayed on the People tab of the Organization's page.
One can be added as a member by including them in a group on the Groups tab.
These members have the option to add apps to the Organization and view a list of all of the
Organization's apps on the Apps tab.
Members can only access an Organization's app, if they are granted access to the app directly or through a
in respect of their assigned role (Admin, Developer or Tester).
What are groups good for?⚓
A group is basically a wrapper for members. By creating groups, Owners and Admins can add multiple members to each app's team at once, making it faster and easier to setup new projects on Bitrise. It also make it faster to reassign, remove and change role of multiple members.
Each group is handled as one entity on the app's
Team tab. They can be added to an app's team,
the group's role can be set, and by removing the Group from the app's Team
you can revoke the access of every member of that group from the app.
It's not possible however to add or delete individual members of a group there, only on the Org's page.
All members of a group have the same role when assigned to an app.
What's the difference between a Team and an Organization?⚓
Teams are handled per app, Organizations are handled globally.
A Team of an Organization's app can contain members invited directly or through the groups assigned to them. Team members with a direct role can only access the app they were invited to and can't add an app to the Organization. Members of a Team always have a role assigned to them (Admin, Developer or Tester).
Who are the "outside contributors"?⚓
Outside contributors are members of an app's Team with a direct role, invited only to an app of an Organization and not to the Organization itself.
Can I have multiple Organizations?⚓
One user can have as many Organizations as they like, but each Organization has to have an active Pro subscription to be able to run builds.
Can I have multiple Pro subscriptions?⚓
Yes. Each account can subscribe to Pro for their personal account and for as many Organizations as needed.
What if I cancel my Pro plan for an Organization?⚓
After the Pro plan expires, builds can't be started for apps owned by the Organization.
Can I remove someone from all of my Organization's apps?⚓
If you are an Owner of an Organization, you can remove members and outside contributors
on the Org's
People tab, with one click. Owners can also remove someone from a group
Groups tab. In this case the user will be removed from all apps' team that the group is assigned to.
Where can I change the avatar for my Organization?⚓
Once you are on your Organization page, click on the avatar, and you'll see a popup to change the color scheme of it. We'll add custom avatar support a bit later.