Managing Your Teams

Members of an organization's Owner's team have total control over repository permissions for each of an organization's users. By setting up teams, you can apply permissions to many users at once. For example, you could create one team for your "platform" developers and another team for your "product" developers. From there, you could configure repository permissions for each team accordingly.

Organization-level permissions in Code Climate are entirely separate from those in GitHub, or any other system. Whether or not a user can view a repository in our system is based entirely on which Code Climate teams they belong to. Each user must be manually invited to join a Code Climate team.

Administrative Permissions

All organizations have an Owners team. Members of this team always have the following administrative permissions:

At the organization-level, permission to do the following:

  • View and configure basic organization settings
  • Configure team members
  • View organization-level tokens (e.g., GitHub service token and API token)
  • Configure billing information
  • View invoices
  • Add new repositories.
  • Receive all invoice emails.

At the repository-level, permission to do the following for ALL of the organization's repositories:

  • View and configure basic repository settings
  • View inferred and committed analysis configuration files (i.e., .codeclimate.yml)
  • View the repository's test coverage tokens
  • Configure integrations

Creating a New Team

  1. From your Dashboard, next to your organization's name, click Organization.
  1. Select Teams.
  1. Click Add Team.
  1. Give your team a name and, optionally, enter a team description. Click Save.

Until you add more users to the new team, its only member will be its creator.

Adding Users to a Team

In order to add a new user to your organization, you should pick a "team" and then add them to it.

  1. From your Dashboard, next to your organization's name, click Organization.
  1. Select Teams.
  1. Click on the name of the Team to which you would like to add a user.
  1. Under the Members section, use the text box to add a new team member. If the user already belongs to your organization (via one or more other teams), their email address will appear as you start typing, which you can then select. If the user doesn't currently belong to your organization, enter their full email address and select it to send them an email invitation.

If you instead want to remove a user from a team, click Remove once you have selected the member's name.

Adding Repositories to a Team

Adding a repository to a team grants non-administrative access to all of the team's members.

  1. From your Dashboard, next to your organization's name, click Organization.
  1. Select Teams.
  1. Click on the Team to which you would like to add a repository.
  1. Under the Repositories section, enter the name of the repository you would like to add, and then select it from the populated list.

If you instead want to remove a repository from a team, click Remove on this page.

Modifying Team Access Per User

Sometimes you'll want to focus on a specific user's permissions. For example, when you add a brand new user to your organization, it's not necessary to individually browse to each team's configuration page one-by-one. Instead, you can browse to the user's dedicated page and set up their team memberships all at once.

  1. From your Dashboard, next to your organization's name, click Organization.
  1. Select People.
  1. Click Edit next to the relevant user's name.
  1. Specify the teams to which the user should belong to and click Save.

Changing a Team's Name and Description

  1. From your Dashboard, next to your organization's name, click Organization.
  1. Select Teams.
  1. Select a team.
  1. Click Settings.
  1. Enter the team's name and optional description. Click Save.

Related Articles

Managing Your Teams