Groups
Groups organize your identities into meaningful segments, such as teams, departments, locations, or the developers reporting to a given manager. Use them to filter reports, compare segments, set objectives, and track costs across your enterprise.
For each group, you can also add a cost per contributor per year, which is used for cost and cost efficiency metrics. Leave it at the default to use the enterprise-wide value.
You can manage your groups in Settings > Groups, where you can filter the list by group type and open any group to review its members and settings. Antenna supports two types of groups: manual and automatic.
Manual Groups
Manual groups are populated by hand. To create a manual group, choose Create group and enter a group name. Next, search for identities to add them as members.
Each membership has a membership window, so you can record when someone joined or left and keep their contribution history attributed correctly.
To keep a manual group in sync with your own system, push its members and their windows with the API.
Automatic Groups
Automatic groups stay in sync with the attributes assigned to identities, such as department and location. To create an automatic group, choose Autosync and select a group type. Antenna shows you a preview of the new groups that will be created based on the distinct values it finds, along with the number of identities that would belong to each group. Supported attributes include company, department, team, manager, product line, location, seniority, and employment type.
Membership of an automatic group is maintained for you. You cannot add members or remove current members directly; to change who belongs to a group, update the underlying attribute on the identity. When the attribute no longer matches, the person leaves the group. Team groups keep them as a past member, as described in Team Groups.
Antenna also automatically maintains an AI-assisted developers group for you that tracks contributors as they start and stop using AI tools.
Enriching Identities
Automatic groups are only as helpful as the attributes on your identities, so we recommend enriching your identities before creating new groups. See Identity Graph for how to upload a CSV and the supported fields.
Team Groups
Team groups keep a history of who was on each team, so work stays with the team it was done for after someone moves.
- When a team is removed from an identity, their membership in that team’s group ends and they appear as a past member. Their earlier contributions still count toward the team.
- When someone moves from one team to another, the new membership starts on the day the old one ends.
- If the team is added back, their membership reopens.
When you remove a team in an identity’s Details or in the Team(s) column, Antenna asks how to handle it:
| Option | Result |
|---|---|
| Left on a date (default) | Ends the membership on that date, which defaults to today. |
| Was never on the team | Removes them from the team’s history, as if they had never been a member. |
When you enrich identities with a CSV, you make the same choice once for the whole upload. Changes from other sources, such as the API, Okta, or bulk edits, always end the membership.
To fix a past membership later, open the group and remove the past member. Current members cannot be removed this way.
Manager Groups
Manager groups are automatic groups synced from the manager attribute, and they cascade through your reporting structure. A manager’s group includes their direct reports and the members of each of those managers’ groups, so a manager of managers covers everyone under them. In group filters, manager groups are nested to reflect that reporting hierarchy.
Group Access
You can restrict an enterprise member’s access to specific groups across Antenna. For example, only those groups are available to the member in dashboard filters. In Settings > App Users, open a member and assign one or more groups under group access. A member with no assigned groups can see every group, and admins always have access to all groups.
Manager groups work especially well with group access. Add the manager attribute to each identity, autosync your manager groups, and assign each manager their corresponding group. Each manager can then access data for their direct and indirect reports, but no one else. When reporting lines change, group membership and access update automatically.