Start Building for Free
CircleCI.comAcademyBlogCommunitySupport

Manage roles and permissions

3 months ago2 min read
Cloud
On This Page

Manage user access to organizations and projects with CircleCI roles and associated permissions. The guides on this page show how to add people to your organization, update permissions, and assign specific project roles to people in your organization. For an overview of roles and permissions in CircleCI, see the Roles and permissions overview page.

Prerequisites

Add people to your organization

  1. In the CircleCI web app, click on Organization Settings in the sidebar

  2. Click on People

  3. Click Invite

  4. Enter the person’s email address. You can add multiple people separated by a space too

  5. Select a role from the dropdown menu to be applied to the people you are inviting

  6. Click Send Invite(s)

An invited user will receive an email notification (sent from noreply@circleci.com), containing a link to accept the invite.

If they do not currently have a CircleCI account, they will need to sign up. If they already have a CircleCI account, they are added to the organization, and if they are logged in, they will see the organization as an option in the organization switcher in the top left corner of the web app.

Change a person’s org-level permissions

  1. In the CircleCI web app, click on Organization Settings in the sidebar

  2. Click on People

  3. Scroll to locate the person you want to update permissions for

  4. Use the dropdow menu next to their name to select a new role

Remove people from your organization

  1. In the CircleCI web app, click on Organization Settings in the sidebar

  2. Click on People

  3. Scroll to locate the person you want to remove

  4. Click the elipsis (…​) button next to their name and select Remove from organization

Assign a project role

Project roles setup page
  1. In the CircleCI web app, click on Dashboard in the sidebar

  2. Select your project using the filter dropdown menu

  3. Click Project Settings

  4. Click People in the sidebar menu

  5. Click Assign Project Roles

  6. Select the username of the person you want to assign a role to

  7. Use the Project Role dropdown menu to select the role you want to assign

  8. Click Assign Role

Change a person’s project-level permissions

  1. In the CircleCI web app, click on Dashboard in the sidebar

  2. Select your project using the filter dropdown menu

  3. Click Project Settings

  4. Click People in the sidebar menu

  5. Use the drowdown menu next to the person’s name to select a new project role

Remove people from your project

  1. In the CircleCI web app, click on Dashboard in the sidebar

  2. Select your project using the filter dropdown menu

  3. Click Project Settings

  4. Click People in the sidebar menu

  5. Click the elipsis (…​) button next to their name and select Remove project role


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.

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.