Managing your enterprise

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 enterprise admins. 

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 lists frequently asked questions about billing and subscriptions. Currently, it doesn't provide a billing view of the different organizations inside the enterprise. You must retrieve this information for each organization inside the enterprise: see Viewing your organization's billing and usage information.
• Portfolios: See Portfolios.
• Administration:  This menu allows you to access administration settings related to your enterprise such as SAML SSO 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 an Enterprise coupon assigned (see Signing up for the Enterprise plan in Signing up for a subscription plan) and is not already part of an enterprise. 

To add an organization to an existing enterprise:

1. Log in to SonarQube Cloud with your enterprise admin account. 
2. Retrieve your enterprise.
3. In the Organizations tab, select the Add button. The Add an organization dialog opens.
4. 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 (for example, 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.). In that case, your enterprise admin account may not be admin of the new organization you want to add to your enterprise. For example, your enterprise admin account is an Azure DevOps account; you have imported a GitHub organization to SonarQube Cloud with your GitHub account; you want to add this organization to your enterprise. 

With the example mentioned above, proceed as follows to define your enterprise admin account as an admin of the organization to be added and then add the organization to your enterprise:

1. Log in to SonarQube Cloud with your GitHub account (the account you used to import your organization).
2. Add your Azure DevOps account (enterprise admin account) as a member of the organization to be added, and add the Administer Organization permission to this account. See Managing the organization members and permissions
3. Log in to SonarQube Cloud with your Azure DevOps account and add the new organization to the enterprise as described above in Adding an organization to an enterprise.

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. 

Proceed as follows:

1. Retrieve the enterprise.
2. In the Organizations tab, select the Remove from Enterprise button at the far right of the organization to be removed. The Remove organization dialog opens.
3. Select the Remove button.

Managing the enterprise-related permissions

You must be an admin of the enterprise to be able to manage the permissions.

Renaming your enterprise

You must be an admin of the enterprise to be able to perform this procedure.

To rename an enterprise:

1. Retrieve your enterprise
2. Go to Administration > Enterprise Settings tab.  
3. In the Enterprise details section, change the enterprise name and select Save.

Downgrading your enterprise

You must be an admin of the enterprise to be able to perform this procedure.

To downgrade an enterprise:

1. Retrieve your enterprise
2. Go to Administration > Enterprise Settings tab. 
3. In the Downgrade enterprise section, select the Downgrade button. The downgrade dialog opens.
4. Enter your enterprise name in the field and select the Downgrade now button.

Related pages

• Administering portfolios
• Onboarding a new organization on your enterprise