Start FreeLog in
SonarCloud | Administering your SonarCloud | Managing your organizations

Was this page helpful?

Managing your organizations

On this page

This section explains how to manage SonarCloud organizations. It's directed at the organization admins.

Retrieving and viewing your organizations

You can view any free plan organization or a paid plan organization if you’re a member. 

Retrieving your organizations

1. Select your account menu in the top right corner of the SonarCloud interface. In the menu, under My Organizations, select the organization you want to view.
Alternatively, open the My Projects page and select the organization hyperlink in the projects list.

 The organization record opens on the Projects page. The organization key is displayed in the top right corner.

2. You can navigate through the different pages (some pages require a specific access permission) :

    • Projects: This page lists the projects belonging to the organization and to which you have access.
    • Quality Profiles: This page allows authorized users to manage the quality profiles available by language for the organization's projects.
    • Rules: This page allows the retrieval of coding rules available in the organization through its quality profiles.
    • Quality Gates: This page allows authorized users to manage the quality gates available for the organization's projects.
    • Members: This page lists the organization's members and allows the organization admins to manage them.
    • Billing  & Upgrade: This page allows the organization admins to manage the organization’s subscription.
    • Administration: This menu allows the organization admins to access various administration menus.
Retrieving any free organization
  • If you know the organization key, go to sonarcloud.io/organizations/<organizationKey>.
  • Otherwise, in the top navigation bar of the SonarCloud UI, select Explore or go to sonarcloud.io/explore/projects, and select an organization.

Setting up an organization

The procedure below explains how to set up an organization when your system uses DOP (DevOps platform) authentication. For SAML SSO authentication, see Onboarding a new organization on a SAML-SSO-enabled enterprise.

  1. Sign up for SonarCloud by using your DevOps platform account. 
  2. Import your DevOps platform organization: see Importing a DevOps platform organization under Onboarding your organization below. The corresponding SonarCloud organization is automatically created, and you’re granted the Administer permission on it.
  3. Set project configurations at the organization level.
  4. Invite your DevOps platform organization users to sign up for SonarCloud. Their SonarCloud account will be automatically created.
  5. If you use a GitHub platform with automatic member synchronization, the organization members are automatically synchronized in SonarCloud. Otherwise, you must add the SonarCloud users to your organization manually.
  6. Manage the permissions of the users and groups. In particular:
  7. Authorized organization members can now create projects.

Onboarding your organization

You create a SonarCloud organization by importing the corresponding DevOps platform organization. The so-created organization is bound to the DevOps platform organization.

You may also create your organization manually (without importing the DevOps platform organization). But in that case, you will not benefit from the advantages of a bound organization.

When you create an organization with a DOP user account, your user account is automatically assigned to the organization’s Owners group which grants you administration rights on the organization. 

Importing a DevOps platform organization
  1. On the top right of the SonarCloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
  2. Select the Import button corresponding to your DevOps platform. See:
Creating an organization manually
  1. On the top right of the SonarCloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
  2. Select the create one manually hyperlink below the Import button.
  3. Enter the organization name and key.
  4. Select the subscription plan.
  5. Select the Create organization button.

Allowing only private projects in your organization

In a paid plan organization, you can restrict project creation to private projects only. If public projects belong to the organization, you must make them private first: see Changing the project's visibility.

To allow only private projects in your organization:

  1. Retrieve the organization (see above).
  2. Go to Administration > Organization settings > Only allow private projects.
  3. Select the Only allow private projects checkbox.
  4. Select Save

Binding an unbound organization

If you created your organization manually, then it’s not bound to its corresponding DevOps platform organization and you don’t benefit from many advantages. This procedure explains how to bind your unbound organization. To do so, you need the corresponding permissions on your DevOps platform.

To bind your unbound organization:

  1. Retrieve the organization (see above).
  2. Go to Administration > Organization settings  > Bind this organization
  3. Select the Choose the organization on <DevOps platform> button. The integration page opens in your DevOps platform.
  4. Follow the instructions.

Changing the organization key

The organization key is set when you import the organization into SonarCloud. At that point, you can choose your own key or accept the suggested key. In some cases, you may later wish to change this key (for example, if a new naming convention is adopted at your company, or if you initially chose a bad key by accident).

To change the key of your organization:

  1. Retrieve the organization (see above).
  2. Go to Administration > Organization settings  >  Edit organization key.
  3. In Key, enter your new key, and select Save.
  4. Make the same change to the sonar.organization setting of every project in the organization that is configured for CI-based analysis, or inform the respective project administrators.

Deleting an organization

You can delete an organization provided you’re an organization admin.

To delete an organization:

  1. Retrieve the organization (see above).
  2. Go to Administration > Organization settings
  3. In the Delete Organization section, select the Delete button. The Delete organization dialog opens.
  4. Enter your organization name and select Delete.

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License