Adding organizations to your enterprise
Add or remove organizations from your enterprise.
When adding an organization to your enterprise, you can either create a new organization or add an existing one. You can also include organizations from different DevOps platforms.
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 new organization. The Create an organization page opens.
Select your DevOps platform 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 you want to add, then select Add. If you cannot see the organization, your enterprise admin account is probably not an admin of that organization. This can happen if you imported the organization with another user account, typically from another DevOps platform. In that case, see If you created your organization using another account.
If you created 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. For example, your enterprise admin account may be a GitHub account, while the organization you want to add is a Bitbucket workspace that you imported with your Bitbucket account. In that case, complete the following extra steps:
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 organization to the enterprise as described in Adding an existing organization.
In this example, 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
You can remove an organization from your enterprise provided:
You are an admin of the enterprise.
You are an admin of the organization.
You are logged in with a SonarQube Cloud account that is not an SSO (SAML) account.
Keep in mind:
When you remove an organization, you must choose its new subscription plan: Free or Team.
You will lose some features. For more information, see Changing your subscription plan.
If the organization you remove is the only member of the enterprise, you will lose access to the enterprise after the removal.
You cannot downgrade an entire enterprise at once.
Proceed as follows:
Retrieve your enterprise. See Retrieving and viewing your enterprise for more information.
Go to Organizations.
Select Remove and downgrade at the far right of the organization you want to remove. The Select an alternate plan to downgrade dialog opens.
Select the new plan.
Select Confirm removal and downgrade, then follow the instructions to complete the new subscription. You will not be able to analyze the organization’s private projects until the subscription is complete.
Related pages
Last updated
Was this helpful?