> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/identity/reports/group-usage.md).

# Group Usage Report

This report lists every group in the selected tenant together with where it is actually used: Conditional Access policies, Intune assignments, Entra role assignments, enterprise application assignments, group-based licensing, Microsoft Teams, nested group membership and Exchange transport rules. Groups nothing references are marked as unused, which makes this the quickest way to find groups that can be cleaned up, and to check what would break before removing one.

## Filters

| Filter                     | Shows                                                                    |
| -------------------------- | ------------------------------------------------------------------------ |
| Unused groups              | Groups that nothing currently references, so are candidates for cleanup. |
| Used in Conditional Access | Groups referenced by at least one Conditional Access policy.             |
| Used in Intune             | Groups referenced by at least one Intune assignment.                     |
| Used for licensing         | Groups used to assign licences through group-based licensing.            |

## Table Details

| Column         | Description                                                                                                                                                                                                                    |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Display Name   | The name of the group.                                                                                                                                                                                                         |
| Group Type     | The kind of group, worked out by CIPP from the group's underlying flags: Microsoft 365, Mail-Enabled Security, Security or Distribution List.                                                                                  |
| Mail           | The group's email address, where it has one.                                                                                                                                                                                   |
| Used Locations | The categories of place that reference the group: Conditional Access, Intune, Entra Roles, Enterprise Applications, Licensing, Teams, Exchange or Group Nesting (membership of another group). Blank when the group is unused. |
| Used In        | The specific policy, assignment or rule behind each reference, one entry per match.                                                                                                                                            |
| Usage Count    | How many references **Used In** lists.                                                                                                                                                                                         |
| Is Used        | Whether the group has any references at all. No when **Usage Count** is zero.                                                                                                                                                  |

{% hint style="info" %}
This report joins several independently cached data sources: groups, Conditional Access, Intune, roles, applications, licences and transport rules. The **Sync** button here refreshes all of them together, which can take a few minutes for larger tenants.
{% endhint %}

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/identity/reports/group-usage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.