Roles and permissions

Cloud

Quickstart

For instructions on managing roles and permissions, see the Manage roles and permissions page.

Organization role permissions matrix

The table below shows the permissions associated with each CircleCI organization role:

ACTIONS	ORGANIZATION ROLES
	Admin	Contributor	Viewer
Organization
Create namespace
Manage namespace
View org settings
Manage org settings
View org access
Manage org access
View org credentials
View org policies
Manage org policies
View org connections
Manage org connections
Manage org credentials
View org audit logs
View plan
Manage plan
Insights
View org insights
Runner
View runners
Manage runners
Projects
View projects
Create projects
Manage project settings
Contexts
View contexts
Use contexts
Edit context variables
Manage contexts
Orbs
Create/update orb
View private orb
Publish dev orb
Publish orb
Webhooks
View org webhooks
Manage org webhooks
View project webhooks
Manage project webhooks
Schedule
View schedule
Edit schedule
Triggers
View triggers
Trigger build
Edit triggers
Config sources
View config sources
Edit config sources
Releases
Create release environment
Delete release environment
View release environment
Create environment token
Revoke environment token
List environment token
View components
View releases

Project role permissions matrix

The table below shows the permissions associated with each CircleCI project role:

ACTIONS	PROJECT ROLES
	Admin	Contributor	Viewer
Projects
View projects
View project access
View project credentials
Manage project
Webhooks
View project webhooks
Manage project webhooks
Schedule
View schedule
Edit schedule
Triggers
View triggers
Trigger build
Edit triggers
Contexts
View contexts
Use contexts
Edit context variables
Manage contexts
Config sources
View config sources
Edit config sources
Releases
Restore component version
Restart component
Scale component
Cancel release
Promote release steps
Retry release

Permissions scope

Your CircleCI roles and associated permissions are not derived from the permissions set in your VCS (version control system). Your CircleCI role permissions do not allow you to bypass permissions in the VCS.

For example, you may be an Organization Administrator within CircleCI, which gives you access to view and modify organization and project settings within your CircleCI organization. However, you will not be able to edit a project’s .circleci/config.yml hosted in your VCS without your user also having the write permissions within that VCS’s repository project. Your CircleCI user’s VCS permissions are determined by its associated VCS identity.

Next steps

Manage roles and permissions

Help make this document better

This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.

Suggest an edit to this page (please read the contributing guide first).
To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.

Need support?

Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.

You can also visit our support site to find support articles, community forums, and training resources.

CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.