Changing project binding and other parameters
This page is directed at the project admin.
Changing the binding of your project
You can bind a project to another repository or you can bind an unbound project to a repository.
Binding a project to another repository
You can change the repository binding of a project provided you have Administer permission on that project and Create projects permission. The following limitations apply:
- The source and target repositories must be in the same organization.
- A public project cannot be bound to a private repository.
The repository change will not impact the automatic analysis activation status of your project except if the target repository is a monorepo and automatic analysis was enabled for your project. In that case, the automatic analysis will be disabled since it's not supported for monorepos and you will need to manually configure a CI-based analysis for your project.
Changing the binding of a project configured with a CI-based analysis may require that you change the CI/CD process configuration for this project.
To bind a project to another repository:
- Retrieve the project.
- Go to Administration > General Settings > Repository binding.
- In the list of repositories, select the target repository and click Save.
Binding an unbound project to a repository
You can bind an unbound project to a repository provided you have Administer permission on that project and Create project permission. Note that a public project cannot be bound to a private repository.
In case you had manually linked your project to a repository, you should remove this manual setup.
To bind an unbound project to a repository:
- Retrieve the project.
- Go to Administration > General Settings > Repository binding.
- In the list of repositories, select the repository and click Save.
You may want to enable the automatic analysis on your newly bound project. To do so, see Activating automatic analysis.
Updating the project binding on repository URL change
In case you renamed your repository or moved it within the same organization, you can update the repository binding to your SonarQube Cloud project as follows:
- Retrieve the project.
- Go to Administration > General Settings > Repository binding.
- In the list of repositories, re-select the target repository and click Save.
Changing the project key
- Retrieve the project.
- In the left sidebar, select Administration > Update Key. The Update Key page opens.
- Enter the new key and select Update.
Related pages
Was this page helpful?
© 2008-2025 SonarSource SA. All rights reserved.
