Skip to content
Start free
Product Demo Pricing Security Docs Changelog Start free

Custom groups

Live ManagerOrg admin
Who can manage
Manager, Org admin
Who can view group metrics
Every role
Where
Admin → Groups

A custom group is a set of people you want to measure together, such as a squad, a project team or a guild. Groups appear next to your GitHub teams in every report, so you can compare them and track them over time. A group can keep a list you edit by hand, or follow a GitHub team so its membership stays current by itself.

Create a group

  1. Open Admin → Groups and select New group.
  2. Enter a Name, such as Frontend. A Description is optional.
  3. Leave Follows team on None (manual group) to pick the members yourself. To follow a GitHub team, see the next section.
  4. Select Create group.
  5. Reopen the group from the list to add members.

The list shows each group’s name, description, Follows team and Members count. Use the search box to find a group and select a row to open it.

Add and remove members in a manual group

  1. Open Admin → Groups and select the group.
  2. Under Members, choose a person in Add a contributor… and select Add.
  3. To remove someone, use the remove button next to their name.

Changes apply as soon as you make them. You do not need to save member changes.

A linked group follows its team. When someone joins or leaves the team on GitHub, the group changes too.

  1. Open Admin → Groups and select New group, or select an existing group.
  2. In Follows team, choose the team. Teams show with their name and slug.
  3. Select Save (or Create group for a new one).

DevGlimpse then adds the team’s members to the group and drops anyone the team no longer has. After that, team changes arrive through GitHub’s membership events and the nightly check, so the group stays in step.

A linked group’s members are managed by the team, so you do not edit them here. If no teams have been imported yet, the list says No provider teams are imported yet; the group stays manual. Team import starts when you connect GitHub. See Integrations.

Note If you set Follows team back to None (manual group), the group keeps its last known members and becomes a manual group you can edit. If the GitHub team is deleted, its groups also become manual groups and keep their members.

View group metrics

  1. Open Teams & Groups in the sidebar. Every custom group and every GitHub team is listed with what it delivered over the window.
  2. Select a group to open its page. You see totals, weekly throughput, cycle time and review latency, PR size, review load, the monthly pulse score and a members table.
  3. Pick a group in the Team or group filter on any other report to scope that report to the group. Groups are listed under Groups, teams under Teams.

You can also press Cmd+K (Mac) or Ctrl+K (Windows and Linux), type @@ and a name to jump straight to a team or group. Groups are labeled Custom group.

Group metrics sum each member once, even when a person has several identities across providers. A person in several groups counts in each of them. See People and identities.

Privacy rules for groups

Team and group numbers are visible to every role, but the members’ rows follow each viewer’s individual visibility scope.

  • A group with fewer people than the workspace’s minimum group size (3 by default) is hidden from everyone, so nobody can be singled out.
  • A group whose people differ from another team, group or attribute slice by fewer than that minimum is also hidden. For example, a group of everyone except one person would reveal that person’s numbers by subtraction.
  • Bots and excluded contributors are not counted toward the size.

An org admin can see and change the minimum under Admin → Settings.

Who can manage groups

Action Org admin Manager Developer
Open Admin → Groups, create, edit and delete groups Yes Yes No
View group metrics Yes Yes Yes

Developers do not have access to the admin area. A read-only workspace, for example one in its offboarding window, refuses changes to groups.

Delete a group

  1. Open Admin → Groups and select the group.
  2. Select Delete group, then confirm with Delete. Select Keep to cancel.

Deleting a group removes the group, not the people in it or their activity.

Common questions

Why does my new group show no numbers?It may have fewer people than the minimum group size, or it may be too close in membership to another team or group. It also shows nothing until its members have activity in the window.
Why can't I edit the members of a group?The group follows a GitHub team, so its team manages the members. Change the team on GitHub, or set Follows team to None (manual group) and edit the members yourself.
A new team member is missing from a linked group.The group updates when the team change reaches DevGlimpse through a GitHub event, or at the latest in the nightly check. A person also has to exist as a contributor, which happens once they have synced activity or been imported with the team.