> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/adding-organizations-to-your-enterprise.md).
# Adding organizations to 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.
{% hint style="info" %}
Currently, Sonar restricts each enterprise to a maximum of 200 organizations.
{% endhint %}
## Creating a new organization
1. Log in to SonarQube Cloud with your enterprise admin account.
2. Retrieve your enterprise. See [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md) for more information.
3. Go to **Organizations**.
4. Select **Create new organization**. The **Create an organization** page opens.
5. Select your DevOps platform and follow the instructions. For more information, see:
* [Importing GitHub organization](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization.md)
* [Importing GitLab group](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group.md)
* [Importing Bitbucket workspace](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace.md)
* [Importing Azure DevOps organization](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization.md)
## 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.
{% hint style="warning" %}
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.
{% endhint %}
Proceed as follows:
1. Log in to SonarQube Cloud with your enterprise admin account.
2. Retrieve your enterprise. See [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md) for more information.
3. Go to **Organizations**.
4. Select **Add organization**. The **Add an organization** dialog opens.
5. 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-used-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:
1. Log in to SonarQube Cloud with your Bitbucket account (the account you used to import your workspace).
2. Add your GitHub account (enterprise admin account) as a member of the organization to be added. See [Adding organization members](/sonarqube-cloud/administering-sonarcloud/managing-organization/users-and-permissions/organization-members.md) for more information.
3. Give this account the Administer Organization permission. See [Managing organization permissions](/sonarqube-cloud/administering-sonarcloud/managing-organization/users-and-permissions/organization-permissions.md) for more information.
4. Log in to SonarQube Cloud with your GitHub account and add the organization to the enterprise as described in [Adding an existing organization](#add-existing-org).
{% hint style="warning" %}
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.
{% endhint %}
## Removing an organization
You can remove an organization from your enterprise provided:
* You are an admin of both the enterprise and the organization.
* You are logged in with a SonarQube Cloud account that is not an SSO 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](/sonarqube-cloud/administering-sonarcloud/managing-subscription/changing-plan.md#reviewing-the-plan-changes).
* 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:
1. Retrieve your enterprise. See [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md) for more information.
2. Go to **Organizations**.
3. Select **Remove and downgrade** at the far right of the organization you want to remove. The **Select an alternate plan to downgrade** dialog opens.
4. Select the new plan.
5. 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
* [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md)
* [Creating your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/creating-your-enterprise.md)
* [Enterprise security](/sonarqube-cloud/administering-sonarcloud/enterprise-security.md)
* [Managing the enterprise-related permissions](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-enterprise-related-permissions.md)
* [Managing the lines of code within your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise.md)
* [Changing enterprise settings](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/changing-enterprise-settings.md)
* [Downgrading your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/downgrading-your-enterprise.md)
* [Recovering enterprise admin access](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/recovering-enterprise-admin-access.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/adding-organizations-to-your-enterprise.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.