Setting project permissions and visibility
Starting in Team plan, a set of permissions defined through a permission template is applied by default to new projects. If you're a project admin, you can update these permissions.
Permissions related to a project
Permission Type | Description |
---|---|
Browse Project | Applies only to private projects (Anyone, including anonymous users, can view the public projects.). Can view the project. |
See Source Code | Applies only to private projects. Can view the source code (via API and web view) provided the Browse project permission is also granted. Note: Since the projects in a free organization are public, it is assumed that open accessibility of source code is expected. However, as a precaution, anonymous and unauthorized users are prevented from easily downloading source code via API and web views. |
Administer Issues | Can perform the following actions:
|
Administer Security Hotspots | Can change the status of a security hotspot. For private projects, the Browse project permission must also be granted. |
Execute Analysis on project | Can start an analysis on the project. This includes the ability to get all settings required to perform an analysis (including secured settings like passwords) and to push analysis results to the SonarQube Cloud server. |
Administer project | Can perform the following actions:
For private projects, the Browse project permission must also be granted. |
Updating or resetting the permissions of your project
You can update the permissions manually or, starting in Team plan, you can reset the permissions by applying a permission template defined by the organization admin.
If you are an organization admin, you can:
- Apply a permission template to several projects of your Enterprise plan organization at a time.
- Recover administration access to an organization's project.
To update the permissions of your project
- Retrieve the project.
- In the left sidebar, select Administration > Permissions. The Permissions page opens.
- To apply a permission template:
- Select the Apply Permission Template button in the top right corner of the page. The Apply Permission Template dialog opens.
- Select the template you want to apply and select the Apply button.
- To update the permissions manually:
- Navigate to the bottom of the page to view the list of users and groups.
- Select the check box to change the permissions.
Changing the project's visibility
The project's visibility may be:
- Public: Anyone, including anonymous users, can view public projects. A public project may be part of any organization.
- Or private: Only authorized users, who are members of the organization, can view a private project. A private project cannot be part of a free plan organization.
If you're a project admin, you can change your project's visibility. Otherwise, you must upgrade your organization to the Team plan.
To change the visibility of your project:
- Retrieve the project.
- In the left sidebar, select Administration > Permissions. The Permissions page opens.
- In the Project visibility section, select the Public or Private checkbox. (You can also upgrade your organization from this section.) The Turn to Private / Public dialog opens.
- Confirm the change.
Was this page helpful?