We recently rolled out a number of new features for all CircleCI users. One of the most requested features focused on the permissions setting. This blog will take a deep dive into the new feature, how it works, and what it means for you and your team using CircleCI.

What are permissions?

Permissions are a new feature on CircleCI that will give you greater control over the settings on your projects. Using permissions, organizations can restrict who can change ‘Project Settings’ on CircleCI. This setting is available at an organization level or at a project level within the organization. To do this, CircleCI leverages GitHub’s permissions to determine users access.

Why should a user or org enable permissions??

After permissions are enabled for your organization, only GitHub repo admins or GitHub owners will be able to make changes to ‘Project Settings’ on CircleCI. This is especially useful for larger teams to make sure your project settings are only changed by team members who have admin access. This is especially useful for larger teams to make sure your project settings are not accidentally updated by non-GitHub admins/owners on the team.

How will this affect my team?

After permissions are enabled for your org, GitHub members and contributors will not be able to make any changes to CircleCI’s ‘Project Settings’ page. This includes setting containers for your organization, project level parallelization setting, build setting etc. GitHub members or collaborators will still be able to use CircleCI’s functionality like Re-build, Re-build with cache or Re-build via SSH.

What if I change my mind? Can I turn this feature off?

If you find that permissions aren’t for you, you can always create a support request (in the app, click the “Help?” button and select “Support”) and we’ll disable permissions for your organization.

Getting Started: How to setup user permission on GitHub?

To setup your team’s access on GitHub, navigate to the following link for your org: https://github.com/orgs/org-name/teams.

You can setup repo level user access using the following link: https://github.com/org-name/repo-name/settings/collaboration.

Read more about setting up team permissions on GitHub.

How do I enable permissions on CircleCI?

If you would like to enable this feature for your organization, or specific projects within your organization, please create a support request (in the app, click the “?” button which when you rollover says “Help?” and select “Support.”)

Is there a feature you would like to see added to CircleCI? You can submit a new topic on the Feature Request category of our community site. You can also vote in our Developers’ Choice Award where we’ve gathered together nine of the most oft-requested features that we would love to build but for a variety of reasons never hit the top of our backlog. This is your chance to vote directly on those features, and we will build whichever gets the most votes. Voting will conclude Monday April 22nd at 5:00 PM PST. Visit Developers’ Choice now to vote for the feature you want us to build next.