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

# Roles & Permissions

> Learn how permissions work in CodSpeed

Permissions for an organization can be accessed by clicking on the `Permissions`
tab on the organization's settings page.

> [!NOTE]
>
> At the moment, CodSpeed only supports roles and permissions defined at the
> organization level. This means that all projects in an organization have the
> same permissions. We plan to add support for project-level permissions in the
> future.

## Joining an organization

The members of a CodSpeed organization are the members of the corresponding
organization on your repository provider, e.g., GitHub or GitLab. Adding someone
there is enough to give them access to CodSpeed.

A user appears in the CodSpeed organization when they:

* Log into CodSpeed while being a member of the provider organization.
* Trigger a CodSpeed run on one of the organization's repositories.

Memberships are synced on every login. Removing a user from the provider
organization also removes them from the CodSpeed organization.

Once a user appears in the `Permissions` tab, an admin can promote them to
admin.

## Roles

Roles are a way to control what a user can do in CodSpeed. There are three
levels of permissions, from highest to lowest:

* **Provider admin**: Users who are admins in GitHub, GitLab, or Bitbucket are
  automatically provider admins in CodSpeed. They cannot be demoted to a lower
  level of permission.
* **Admin**: Admins can promote and demote users to and from the admin level.
  They have full write access to CodSpeed.
* **Member**: Members have basic read-only access to CodSpeed.

## Permissions

The following table shows what each role can do in CodSpeed.

| Permission | Provider admin | Admin | Member |
| :- | :-: | :-: | :-: |
| View projects | | | |
| Add projects | | | |
| View project settings | | | |
| Edit project settings | | | |
| View project members | | | |
| Edit project members roles | | | |
| Manage billing | | | |
| Acknowledge regressions | | | |

For details on how seats and billing work, see
[Seats & Billing](https://codspeed.io/docs/features/seats-and-billing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.