Managing contributors and teams

In this article

• About contributors and teams in GitHub Insights
• Editing a contributor
• Managing contributor visibility
• Merging contributor data
• Auto-merging contributors
• Manually merging contributors
• Unmerging a contributor
• Managing teams in GitHub Insights
• Creating a team
• Adding contributors to a team
• Removing a contributor from a team
• Renaming a team
• Deleting a team

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.

   

2. Under Settings, click Contibutors.

   

3. To the right of the contributor you want to manage, click Edit.

   

4. Under "First Name", type the contributor's first name.

   

5. Under "Last Name", type the contributor's last name.

   

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.

   

2. Under Settings, click Contibutors.

   

3. To the right of the contributor you want to manage, click Edit.

   

4. Select or deselect Show 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.

   

2. Under Settings, click Contibutors.

   

3. Under "All Contributors", click Auto-Merge

   

4. Optionally, to exclude a contributor from being merged, to the right of the contributor, click Skip.

   

5. For each group, select a primary contributor.

   

6. Click Merge All.

Manually merging contributors

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Contibutors.

   

3. Select the contributors you want to merge.

   

4. Under "All Contributors", click Merge.

   

5. Select a primary contributor.

   

6. Click Merge accounts.

Unmerging a contributor

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Contibutors.

   

3. To the right of the contributor, click Unmerge.

   

Managing teams in GitHub Insights

Teams in your GitHub Enterprise Server instance are not available in GitHub Insights. You must create separate teams in GitHub Insights.

Creating a team

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Teams.

   

3. To the right of "Teams", click Create Team.

   

4. Under "Team Name", type a unique name for your team.

   

5. Click Create.

Adding contributors to a team

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Teams.

   

3. Next to the team you'd like to add contributors to, click Edit Team.

   

4. Under "Contributors", use the drop-down menu and select a contributor.

   

5. Click Done.

Removing a contributor from a team

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Teams.

   

3. Next to the team you'd like to add contributors to, click Edit Team.

   

4. To the right of the contributor you'd like to remove, click .

   

Renaming a team

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Teams.

   

3. Next to the team you'd like to add contributors to, click Edit Team.

   

4. Under "Team Name", type a unique name for your team.

   

5. Click Rename.

   

6. Click Done.

Deleting a team

1. In GitHub Insights, click Settings.

   

2. Under Settings, click Teams.

   

3. Next to the team you'd like to add contributors to, click Edit Team.

   

4. Click Delete Team.

   

5. Click Confirm.