Control administrative access
You can control which CodeRabbitadministrative features are available to your organization's user accounts byassigning and updating account roles.
Overview of CodeRabbit roles
Every CodeRabbit account has exactly one role for each organizationthat account is associated with.For example, if you belong to two GitHub-based organizations that useCodeRabbit, then you have one CodeRabbit role set for each of those twoorganizations.
CodeRabbit roles determine your ability to read or change variousbilling, account management, and other administrative functions related toan organization. The roles are as follows:
- Admin: allows full read/write access to all CodeRabbit administrative features.
- Member: allows read-only access to a limited set of administrative settings. This roleis appropriate for most developers in an organization.
- Billing Admin: allows read/write access to features specificto a subscription and billing management, and limited access to other administrative features.
CodeRabbit users with theAdmin role can modify the roles of other users in theorganization.
For a complete list of the administrative functions available to each role, seeRole permissions.
CodeRabbit roles and Git platform roles
Modifying an account's CodeRabbit role doesn't have any "upstream"effect on that account's role or permissions in your organization's Git platform.Similarly, changes to an account's role on your organization's Git platform don'taffect that account's CodeRabbit role.
For example, if you have CodeRabbit integrated with a GitHub organization, and you change an account's CodeRabbit role fromMember toAdmin, then that account'spermission or ownership level with your GitHub organization doesn't change as a result.
CodeRabbit roles and developer features
CodeRabbit roles affect only access to administrative features. Roles have no effect on using CodeRabbit developer features, such as automated code reviews.
For example, if an organization has a Pro-tierCodeRabbit account, then any user account with a seat assigned to it can use Pro-tier features with the organization's private repositories, regardless of that account's role.
For more information on seat and subscription management, seeManage your subscription.
Default roles
CodeRabbit assigns every user account in your organization a default role,using the following metrics:
- If a user has an ownership-level role with the Git platform organization—for example,Admin on GitHub, orOwner on Bitbucket—then that user receives the defaultCodeRabbit role ofAdmin.
- Otherwise, the user receives theMember role by default.
You can update a user's role from its default setting by following the steps detailed in the next section. This requires that your own accounthas anAdmin role with the organization.
CodeRabbit applies these defaults only when initially setting up for anaccount within an organization. Subsequent "upstream" role changes don't affectan account's CodeRabbit role.
View or set roles
You can view and set roles from the CodeRabbit dashboard, as detailed in thefollowing sections.
View roles
To view a list of your organization's role assignments, follow these steps:
- Go to theCodeRabbit dashboard.
- At the top of the sidebar, select the organization whose user roles you want to view.
- On the sidebar, clickSubscription.
This displays a table of all of the CodeRabbitAdmin andMember accounts associated with the selectedorganization. In this table, theRole column displays the CodeRabbit role foreach account.
To view a list of accounts with theBilling Admin role, click theBilling Admins tab located above the table of user accounts.
Set roles
To modify users' CodeRabbit accounts, your own account must have theAdmin role within your organization.
To change a user account's CodeRabbit role, follow these steps:
- Go to your organization's list of user accounts, as detailed in the previous section.If you have theAdmin role within this organization, then theRole column in the user accounts table contains selectable menus.
- Click the menu in the user'sRole column, and select the appropriate role fromthe list.
The only roles you can assign through this method areAdmin andMember.You can't grant theBilling Admin role to an existing user account. To add an account with theBilling Admin role, see the next section.
Add billing admin accounts
Billing Admin users don't require CodeRabbit seat licenses. You can add Billing Admin users regardless of how many seat licenses you have available.
To add a CodeRabbit user account with theBilling Admin role, follow these steps:
- Go to your organization's list of user accounts, as detailed inView roles.
- ClickInvite Billing Admin.
- Enter the name and email address of the billing administrator who you want to invite to the organization.
This sends an email to the address that you specified. After the recipient completes the process of joining your organization in CodeRabbit, then their record appears in the user accounts list, under theBilling Admins tab.
Role permissions
The following table lists the CodeRabbit administrative functionalityavailable to each of the CodeRabbit roles.
| Resource | Admin | Member | Billing Admin |
|---|---|---|---|
| Learning Resources | Read/Write | Read-only | No access |
| Metrics/Dashboard | Read/Write | No access | No access |
| Reports | Read/Write | Read-only | No access |
| Integrations | Read/Write | Read-only | No access |
| Repository Settings | Read/Write | Read-only | No access |
| Organization Settings | Read/Write | Read-only | No access |
| User Management | Read/Write | Read-only | Read-only |
| Subscription Management | Read/Write | Read-only | Read/Write |
| Billing Management | Read/Write | No access | Read/Write |