> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cubic.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles and permissions

> Manage team roles and permissions in cubic

cubic uses a role-based access control system to manage who can make changes to your team's subscription and settings. Every team member has one of two roles:

## How to become an admin

There are three ways to become a cubic admin:

1. **Install the cubic GitHub app** - When you install cubic for your GitHub organization, you automatically become the first admin
2. **Be a GitHub organization admin** - GitHub organization admins automatically become cubic admins when the app is installed
3. **Get promoted by an existing admin** - Any current admin can promote you to admin status through the [subscription settings](https://www.cubic.dev/settings?tab=subscription)

## Admin role

Admins have full control over team management and can:

* **Manage seat assignments:** Add or remove cubic seats for team members
* **Manage roles:** Promote members to admin or demote other admins to members (note: bot accounts cannot be admins)
* **Configure auto-assign:** Enable automatic seat assignment and removal when GitHub organization members join or leave
* **Bulk actions:** Select multiple users to manage seats and roles in bulk

## Member role

Members can use cubic's full feature set but have limited administrative access:

* **Full platform access:** Use all cubic features including AI reviews, analytics, and PR management
* **View settings:** See team configuration and subscription status (read-only)
* **No seat management:** Cannot assign/remove seats or change user roles

## How to manage user roles

Only admins can change user roles. cubic provides both individual and bulk role management:

### Individual role changes

To promote or demote a single user:

1. Navigate to [Settings → Subscription](https://www.cubic.dev/settings?tab=subscription)
2. Find the team member in the list
3. Click the three-dot menu (⋮)
4. Select "Promote to Admin" or "Demote to Member"
5. The change takes effect immediately

<Note>Only admins can see and use these options. Members see a read-only view of the team.</Note>

### Bulk role changes

To change roles for multiple users at once:

1. Navigate to [Settings → Subscription](https://www.cubic.dev/settings?tab=subscription)
2. Use the checkboxes to select multiple team members
3. Click "Update role" in the bulk action bar
4. Choose "Promote X users to admin" or "Demote X users to member"
5. All selected users are updated immediately