Managing your enterprise
On this page
This section is directed at the enterprise and organization admins. It explains how to set up and update an enterprise, and how to manage the permissions set at the enterprise level.
As of 15 July 2025, SonarQube Cloud offers enterprise-level subscriptions, thus allowing a simplified setup process. Enterprises created prior to this date will be migrated to the new process soon. In the interim, please refer to Managing your enterprise (old process).
Retrieving and viewing your enterprise
You can view the enterprises you’re an admin or a member of.
To retrieve and view your enterprise:
1. Select your account menu in the top right corner of the SonarQube Cloud interface. In the menu, under My Enterprises, select the enterprise you want to view. The Organizations page of the enterprise opens.

2. You can navigate through the different pages of the enterprise (The administration pages are restricted to the enterprise admins.):
- Organizations: This page lists the organizations belonging to the enterprise and of which you're a member. It allows admins to add or remove organizations.
- Billing: This page shows the Lines of Code (LOC) consumption in your enterprise.
- Portfolios: See Portfolios.
- Administration: This menu allows you to access administration settings related to your enterprise such as Single Sign-On authentication and enterprise-related permissions (see Managing enterprise-related permissions below).
Creating your enterprise
See Setting up your enterprise in the Getting started with Enterprise section.
Adding an organization to an enterprise
You can add an organization to an existing enterprise provided:
- You are an admin of both the enterprise and the organization.
- The organization to be added has no coupon assigned. Contact our team to deactivate your coupon.
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.
To add an organization to an existing enterprise:
- Log in to SonarQube Cloud with your enterprise admin account.
- Retrieve your enterprise.
- In the Organizations tab, select the Add organization button. 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 Adding organizations belonging to multiple DevOps platforms below.
Adding organizations belonging to multiple DevOps platforms
You can add to your enterprise organizations belonging to multiple DevOps platforms (The prerequisites described above in Adding an organization to an enterprise apply.).
When possible, use the same admin account to create your enterprise and import the organizations you want to add to your enterprise.
Currently, the following apply (The limitations on Bitbucket organization import will be removed in a future SonarQube Cloud release.):
- To import a Bitbucket workspace, you must log in to SonarQube Cloud with your Bitbucket account.
- To import a GitHub organization, a GitLab group, or an Azure DevOps organization, you can use any account, including your SSO account.
If you use different admin accounts (e.g., if your enterprise should contain GitHub organizations and Bitbucket workspaces), your enterprise admin account may not be an admin of the new organization you want to add to your enterprise. For example, your enterprise admin account is a GitHub account; you have imported a Bitbucket workspace to SonarQube Cloud with your Bitbucket account, and you want to add the so-created organization to your enterprise. 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, and give this account the Administer Organization permission.
- 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 Downgrading an organization > Reviewing the plan changes in Changing your subscription plan.
Proceed as follows:
- Retrieve the enterprise.
- In the Organizations tab, 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.
Managing the enterprise-related permissions
You must be an admin of the enterprise to be able to manage the permissions.
Enterprise-related permissions
Permission | Description |
---|---|
Administer Enterprise | An enterprise must have at least one admin (The initial user who created the enterprise is automatically its admin.). An enterprise admin can:
|
Create Portfolios | Can create portfolios. |
We recommend having two admins per enterprise.
Setting the permissions of users
- Retrieve your enterprise.
- Go to Administration > Enterprise Permissions.
Renaming your enterprise
You must be an admin of the enterprise to be able to perform this procedure.
To rename an enterprise:
- Retrieve your enterprise
- Go to Administration > Enterprise Settings tab.
- In the Enterprise details section, change the enterprise name and select Save.
Downgrading your enterprise
You currently cannot downgrade an enterprise. However, you can downgrade each organization in the enterprise, except one. See Removing an organization from your enterprise above.
Related pages
Was this page helpful?