CircleCI Logo
Navigation Menu Icon

Manage groups

Language Icon 1 month ago · 5 min read
Cloud
Contribute Go to Code
If you authenticated your CircleCI account with GitLab or the CircleCI GitHub App, the content on this page applies to you.

Use groups to manage access to projects and features. By creating groups based on teams or roles within your organization, you can, for example, add a user to a group to give them access to all required projects (for example, mobile projects, DevOps projects). For more information about the roles available, and their associated permissions, see the Roles and permissions overview page.

The how-to guides on this page provide steps for some common group management tasks.

Prerequisites

  • A CircleCI account connected to your code. You can sign up for free.

  • At least one project created in your organization. See the Create a project page for instructions.

Create a group

To do this, you must have the Organization Admin role.

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

  2. Select Groups from the sidebar

  3. Click Create Group

  4. Enter a name and description (optional) for your group

  5. Click Create Group

View your new group in the groups list. Click on the group name to view details. You can now add people to the group.

Add people to a group

To do this, you must have the Organization Admin role.

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

  2. Select Groups from the sidebar

  3. Click on the name of the group you want to add people to

  4. On the group page, click Add members

  5. In the popup, search or scroll for users to add to your group. You can select multiple users on one session. When you have made your selection, click Save

Add a group to a project

To do this, you must have the Organization Admin role.

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

  2. Click on the ellipsis next to your project more icon and then click Project Settings

  3. Select Groups from the sidebar

  4. Click Add Groups

  5. Select the group name and then use the dropdown to assign a project role (Admin/Contributor/Viewer)

Assign a new project role to a group

To do this, you must have the Organization Admin role.

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

  2. Click on the ellipsis next to your project more icon and then click Project Settings

  3. Select Groups from the sidebar

  4. Locate the group in the list and open up the "Project Grant" dropdown to access all role options

  5. Select the new role you wish to assign to the group for this project. You will see a notification to confirm when the change is complete

Delete a group

To do this, you must have the Organization Admin role.

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

  2. Select Groups from the sidebar

  3. Click on the name of the group in the list to view the group details page

  4. Click Delete group

Remove a user from a group

To do this, you must have the Organization Admin role.

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

  2. Select Groups from the sidebar

  3. Click on the name of the group in the list

  4. Click on the checkbox next to the user you want to remove from the group, and click Remove Members