Skip to content
This documentation applies to Codacy Self-hosted v8.1.0

For the latest updates and improvements, see the latest Cloud documentation instead.

Roles and permissions for synced organizations#

Your team members have different permission levels on Codacy depending on their role on your Git provider. To change the permission level of a user on Codacy, you must adjust their role directly on your Git provider so that Codacy will use the corresponding permission level on the next time that the user logs in to Codacy.

See the Codacy permission levels that correspond to each role on your Git provider:

See managing people to list and manage the members of your Codacy organization.

Permissions for GitHub#

The table below maps the GitHub Cloud and GitHub Enterprise roles to the corresponding Codacy permission levels and the operations that they're allowed to perform:

GitHub role Outside
Collaborator1
Repository
Read
Repository
Triage
Repository
Write
Repository
Maintain
Repository
Admin
Organization
Owner
Codacy permission level - Repository
Read
Repository
Write
Repository
Admin
Organization
Admin
Join organization No Yes2 Yes2 Yes2 Yes2
View private repository No Yes Yes Yes Yes
Ignore issues and files,
configure code patterns and file extensions,
manage branches
No Configurable Configurable Yes Yes
Upload coverage
using an account API token
No No Yes Yes Yes
Configure repository No No No Yes Yes
Add and remove repository No No No Yes Yes
Manage coding standards,
bulk copy patterns
No No No No Yes
Invite and accept members,
modify billing
No No No No Yes

1: Outside Collaborators aren't supported as members of organizations on Codacy. You can still add Outside Collaborators to Codacy so that Codacy analyzes their commits to private repositories, but they won't be able to join your Codacy organization.
2: Joining an organization may need an approval depending on your setting for accepting new people.

Permissions for GitLab#

The table below maps the GitLab Cloud and GitLab Enterprise roles to the corresponding Codacy permission levels and the operations that they're allowed to perform:

GitLab role External
User1
Project
Guest
Project
Reporter
Project
Developer
Project
Maintainer
Project
Owner
Group
Owner
Administrator
Codacy permission level - Repository
Read
Repository
Write
Repository
Admin
Organization
Admin
Join organization No Yes2 Yes2 Yes2 Yes2
View private repository No Yes Yes Yes Yes
Ignore issues and files,
configure code patterns and file extensions,
manage branches
No Configurable Configurable Yes Yes
Upload coverage
using an account API token
No No Yes Yes Yes
Configure repository No No No Yes Yes
Add and remove repository No No No Yes Yes
Manage coding standards,
bulk copy patterns
No No No No Yes
Invite and accept members,
modify billing
No No No No Yes

1: External Users aren't supported as members of organizations on Codacy. You can still add External Users to Codacy so that Codacy analyzes their commits to private repositories, but they won't be able to join your Codacy organization.
2: Joining an organization may need an approval depending on your setting for accepting new people.

Permissions for Bitbucket#

The table below maps the Bitbucket Cloud and Bitbucket Server roles to the corresponding Codacy permission levels and the operations that they're allowed to perform:

Bitbucket role Read Write1 Admin
Codacy permission level Repository
Read
Organization
Admin
Join organization Yes2 Yes2
View private repository Yes Yes
Ignore issues and files,
configure code patterns and file extensions,
manage branches
Configurable Yes
Upload coverage
using an account API token
No Yes
Configure repository No Yes
Add and remove repository No Yes
Manage coding standards,
bulk copy patterns
No Yes
Invite and accept members,
modify billing
No Yes

1: Codacy can't distinguish the Bitbucket roles Read and Write because of a limitation on the Bitbucket API.
2: Joining an organization may need an approval depending on your setting for accepting new people.

Configuring who can change the analysis configuration#

By default, only users with the Codacy permission level Repository Write can change analysis configurations.

To change this, open your organization Settings, page Member privileges, and define the lowest Codacy permission level required to perform the following operations on the repositories of your organization:

Configuring who can change analysis configurations

Note

Codacy determines the permission level of each user from the role that each user has on your Git provider:

See also#

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

We're sorry to hear that. Please let us know what we can improve:

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact support@codacy.com.

Last modified May 26, 2022