> 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/tenant/reports/graph-office-reports.md).

# Graph / Office Reports

This page gives you direct access to the usage and activity reports Microsoft publishes for a tenant, covering areas such as mailbox usage, OneDrive storage, Teams activity, and licence assignment. Rather than curating a fixed set, CIPP asks the tenant which reports it offers and lists whatever comes back, so the selection reflects that tenant's own licensing and enabled services.

{% hint style="danger" %}
Not every report in this list will function for every tenant. The list of available reports is extensive and includes those that may not match tenant licensing, feature enablement, etc. Reports that are not available for a tenant will return a status code of 500.
{% endhint %}

## How to use this page

{% stepper %}
{% step %}

### Select Source

Choose between **Microsoft Graph** and **Office Reports (reports.office.com)**. The two draw on different reporting services and offer different reports, so it is worth checking both if you cannot find what you need. Microsoft Graph is selected by default.
{% endstep %}

{% step %}

### Select Available Report

The Report list is populated from the tenant based on your source selection. Changing the source clears the current report and reloads the list.
{% endstep %}

{% step %}

### Select Report Period

Choose how far back the report should reach: 7, 30, 90, or 180 days. This defaults to 30 days.

Period only applies to Microsoft Graph reports that accept a timeframe, so the selector is hidden for Office Reports and for the handful of Graph reports that return a current snapshot rather than a period of activity.
{% endstep %}

{% step %}

### Review Report

The report loads automatically. Changing the report or the period fetches a fresh copy. The results table supports the usual filtering and export options, so a report can be exported for a client or for further analysis.
{% endstep %}
{% endstepper %}

## Anonymised Reports

Microsoft 365 has a tenant-wide setting that conceals user and site names in usage reports, replacing them with hashes rather than user principal names. Where CIPP detects that a report has come back anonymised, it shows a warning above the results.

The fix is on the tenant, not in CIPP. Enabling the **Enable Usernames instead of pseudo anonymised names in reports** standard turns the setting off, after which the report needs running again to pick up real names.

{% hint style="info" %}
This setting also affects reports elsewhere in CIPP, and in the Microsoft 365 admin center itself, so it is worth resolving for any tenant where you rely on usage reporting.
{% 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/tenant/reports/graph-office-reports.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.