GitHub Enterprise Server 2.22 is currently under limited release as a release candidate.

Managing contributors and teams

You can manage the people and teams included in metrics and reports.

People with admin permissions in GitHub Insights can manage contributors and teams.

GitHub Insights is available with GitHub One. For more information, see "GitHub's products."

In this article

Did this doc help you?

About contributors and teams in GitHub Insights

A contributor in GitHub Insights is an entity associated with GitHub Enterprise data. You can edit and hide contributors.

Sometimes, the same person can appear as more than one contributor. For example, if one person has used multiple commit email addresses in Git, there will be a unique contributor for each email address in GitHub Insights. You can merge multiple contributors to combine all the data from one person.

You can also group contributors into teams. You can use teams as a filter on reports. For more information, see "Viewing key metrics and reports."

Editing a contributor

You can edit a contributor's display name in GitHub Insights.

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Contibutors.
    Contributors tab
  3. To the right of the contributor you want to manage, click Edit.
    Edit button
  4. Under "First Name", type the contributor's first name.
    First Name field
  5. Under "Last Name", type the contributor's last name.
    Last Name field
  6. Click Rename.

Managing contributor visibility

Hiding a contributor excludes all data associated with that contributor from all metrics.

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Contibutors.
    Contributors tab
  3. To the right of the contributor you want to manage, click Edit.
    Edit button
  4. Select or deselect Show contributor.
    Checkbox to show or hide contributor
  5. Click Done.

Merging contributor data

When you merge two or more contributors, the GitHub Insights data for those contributors becomes associated with one primary contributor. All of the merged contributor data belongs to the primary contributor in metrics.

You can merge contributors manually or automatically, based on contributors GitHub Insights has detected with matching names.

Auto-merging contributors

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Contibutors.
    Contributors tab
  3. Under "All Contributors", click Auto-Merge
    Auto-Merge button
  4. Optionally, to exclude a contributor from being merged, to the right of the contributor, click Skip.
    Skip button
  5. For each group, select a primary contributor.
    Radio buttons to select primary contributor
  6. Click Merge All.

Manually merging contributors

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Contibutors.
    Contributors tab
  3. Select the contributors you want to merge.
    Select contributors
  4. Under "All Contributors", click Merge.
    Merge button
  5. Select a primary contributor.
    Radio buttons to select primary contributor
  6. Click Merge accounts.

Unmerging a contributor

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Contibutors.
    Contributors tab
  3. To the right of the contributor, click Unmerge.
    Unmerge button

Managing teams in GitHub Insights

There are two types of teams in GitHub Insights: teams imported from GitHub Enterprise and custom teams.

When an organization is added to GitHub Insights, all of the organization's teams are imported from GitHub Enterprise. You can search and filter by these teams in GitHub Insights. You can manage the teams in GitHub Enterprise.

You can create and manage custom teams in GitHub Insights. Custom teams may include members from multiple organizations in GitHub Enterprise.

Creating a custom team

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Teams.
    Teams tab
  3. To the right of "Teams", click Create Team.
    Create Team button
  4. Under "Team Name", type a unique name for your team.
    Team Name field
  5. Click Create.

Adding contributors to a custom team

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Teams.
    Teams tab
  3. Next to the team you'd like to add contributors to, click Edit Team.
    Edit Team button
  4. Under "Contributors", use the drop-down menu and select a contributor.
    Contibutors drop-down
  5. Click Done.

Removing a contributor from a custom team

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Teams.
    Teams tab
  3. Next to the team you'd like to add contributors to, click Edit Team.
    Edit Team button
  4. To the right of the contributor you'd like to remove, click .
    Trashcan button

Renaming a custom team

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Teams.
    Teams tab
  3. Next to the team you'd like to add contributors to, click Edit Team.
    Edit Team button
  4. Under "Team Name", type a unique name for your team.
    Team Name field
  5. Click Rename.
    Rename button
  6. Click Done.

Deleting a custom team

  1. In GitHub Insights, click Settings.
    Settings tab
  2. Under Settings, click Teams.
    Teams tab
  3. Next to the team you'd like to add contributors to, click Edit Team.
    Edit Team button
  4. Click Delete Team.
    Delete Team button
  5. Click Confirm.

Did this doc help you?