Adding organizations to your enterprise
Adding or removing organizations to / from your enterprise.
When adding an organization to your enterprise, you have two options: you can either create a new one or add an existing one. Furthermore, you can include organizations from various DevOps platforms.
Currently, Sonar restricts each enterprise to a maximum of 200 organizations.
Prepare the organizations to be added
To create a new organization to be added to your enterprise, import the DevOps platform organization and select the Free plan. For instructions to import your DevOps organization, see:
If you add a Team plan organization to your enterprise, the organization’s Team plan subscription will be automatically cancelled and the organization will be moved to the Enterprise plan without a refund. Therefore, we recommend adding your organizations before their next billing date to avoid double charges.
Add the organizations to your enterprise
Log in to SonarQube Cloud with your enterprise admin account.
Retrieve your enterprise. See Retrieving and viewing your enterprise for more information.
Go to Organizations.
Select Add organization. The Add an organization dialog opens.
Select the organization to be added and select the Add button. If you cannot see your organization, it probably means that your enterprise admin account is not admin of the organization. It may be the case if you imported your organization by using another user account (typically, from another DevOps platform’s account). In that case, see Creating a new organization below.
Creating a new organization
Log in to SonarQube Cloud with your enterprise admin account.
Retrieve your enterprise. See Retrieving and viewing your enterprise for more information.
Go to Organizations.
Select Create organization. The Create an organization page opens.
Select your DevOps platform service and follow the instructions. For more information, see:
Adding an existing organization
You can add an existing organization to your enterprise provided you are an admin of both the enterprise and the organization.
If you add a Team plan organization to your enterprise, the organization’s Team plan subscription will be automatically cancelled and the organization will be moved to the Enterprise plan without a refund. Therefore, we recommend adding your organizations before their next billing date to avoid double charges.
Proceed as follows:
Log in to SonarQube Cloud with your enterprise admin account.
Retrieve your enterprise. See Retrieving and viewing your enterprise for more information.
Go to Organizations.
Select Add organization. The Add an organization dialog opens.
Select the organization to be added and select the Add button. If you cannot see your organization, it probably means that your enterprise admin account is not admin of the organization. It may be the case if you imported your organization by using another user account (typically, from another DevOps platform’s account). In that case, see below.
If you ceated your organization using another account
If you used different admin accounts to import your organizations, your enterprise admin account may not be an admin of the existing organization you want to add to your enterprise. For example, your enterprise admin account is a GitHub account; you want to add a Bitbucket workspace you imported to SonarQube Cloud with your Bitbucket account. In that case, additional steps are necessary as described below:
Log in to SonarQube Cloud with your Bitbucket account (the account you used to import your workspace).
Add your GitHub account (enterprise admin account) as a member of the organization to be added. See Adding organization members for more information.
Give this account the Administer Organization permission. See Managing organization permissions for more information.
Log in to SonarQube Cloud with your GitHub account and add the new organization to the enterprise as described above in Adding an organization to an enterprise.
In the example above, if the Bitbucket account and the enterprise admin account use the same email address, the procedure will not work. To solve the problem, let another user perform steps 1 and 2 with their Bitbucket account.
Removing an organization from your enterprise
You can remove an organization from an existing enterprise provided:
You are an admin of both the enterprise and the organization through a SonarQube Cloud account that is not an SSO account.
The organization to be removed is not the only member of your enterprise (you currently cannot downgrade an entire enterprise).
When you remove an organization, you have to choose the organization’s new subscription plan (Free or Team). Be aware that you’ll loose features. For more information, see Changing your subscription plan.
Proceed as follows:
Retrieve your enterprise. See Retrieving and viewing your enterprise for more information.
Go to Organizations.
Select the Remove and downgrade button at the far right of the organization to be removed. The Select an alternate plan to downgrade dialog opens.
Select the plan
Select the Confirm removal and downgrade button and follow the instructions to complete your subscription. Note that you will not be able to analyze your organization’s private projects as long as you haven’t completed your new subscription.
Related pages
Last updated
Was this helpful?