# Usage reports: Understand how your organization uses Amplitude

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

Usage reports show how your organization uses Amplitude across two tabs: User Metrics, with ten charts on adoption and engagement, and Event Usage, a downloadable report of event use across all projects. Use them to find where your analytics practice is strongest and where teams can get more value from Amplitude.

## Access usage reports

Usage reports include ten charts on the User Metrics tab with metrics that help drive Amplitude adoption in your organization. Usage reports also include a report on the Event Usage tab that describes how your organization uses ingested events within Amplitude across all projects.

To access usage reports, navigate to _Settings > Organization settings > Usage Reports_.

> **Note:**
>
> Only admins or managers on all projects can view usage reports.

## The User Metrics tab

User metrics provide insight into how users within your organization used Amplitude over the defined time period.

### Summary of metrics and users

The Summary Metrics chart displays the total number of users in your organization, along with metrics that summarize Amplitude adoption and engagement. The three trend-over-time metrics show the percentage change in retention, weekly learning users, broadcasted learnings, and engagement by team over the past 90 days.

### User metrics

The User Metrics panel provides information on active user count, top users and teams, and depth of engagement. You can set the active users chart to display data on a monthly, weekly, or daily basis by clicking the buttons in the top corner. The summary statistics in this chart work the same as the ones in the [KPI view](#detailed-kpis).

The Top Users / Teams chart shows which users or teams in your organization performed the most queries in Amplitude. In this chart, a "query" occurs whenever someone creates or loads a chart, dashboard, or notebook. When you switch from top users to top teams, the value reflects the teams users selected when they created their Amplitude account.

Amplitude calculates depth of engagement using the number of edits per session as a proxy. More edits suggest users are highly engaged in the charts they’re viewing.

### Detailed KPIs

The Detailed KPIs panel gives you a more in-depth look at some metrics from the Summary Metrics panel. **Weekly learning users** measures the breadth of Amplitude engagement in your organization. It counts active Amplitude users who've shared a learning that at least two other people consumed in the previous seven days.

**Broadcasted learnings** measures depth. It counts charts, dashboards, and notebooks that two or more people consumed in a seven-day period. [Learn more about the metrics and why they're important](https://amplitude.com/north-star/amplitudes-north-star-metric-and-inputs).

### Content usage

The Content Usage panel shows the Amplitude features and content your people rely on most, including chart types, dashboards, and notebooks. You can view content by clicking the titles if you have the required permissions.

### Export the usage report

To export the report as a PDF or PNG, click the export icon in the upper-right corner.

## The Event Usage tab

The Event Usage tab provides a downloadable, **organization-level** usage report in CSV or JSON format. This report details event use across all projects and portfolios within your organization. Organization admins can generate an up-to-date report by clicking **Generate Report**.

Amplitude measures event use by **queries**. Amplitude defines a query as the **selection of an event** in the definition of a chart, segment, or cohort. When you use [custom events](https://amplitude.com/docs/analytics/charts/event-segmentation/event-segmentation-in-line-events) or metrics composed of multiple events, Amplitude tallies queries for each component event separately.

Amplitude also tallies queries for events queried in [cross-project views](https://amplitude.com/docs/analytics/user-data-lookup), or when an event appears in the path in a [pathfinder analysis](https://amplitude.com/docs/analytics/charts/journeys/journeys-understand-paths).

> **Note:**
>
> If you don't have access to the query counts feature, contact Amplitude Support to enable it.

Both files include every event that has ever appeared in Amplitude, including blocked and deleted events.

#### CSV fields and definitions

- **Event volume**: Total event volume ingested by Amplitude.
- **First Seen & Last Seen**: First and last ingestion date for the event.
- **N Day Queries**: Count of queries in the last N days.
- **N Day Volume**: Total count of event ingestion in the last N days.
- **# of Users**: Total number of users who have ever queried an event.
- **# of Charts**: Total count of all charts that have ever included the event in their definitions.
- **# of Cohorts**: Total count of cohorts that have ever included the event in their definitions.
- **User IDs**: A list of the email addresses.
- **Chart IDs**: A list of the chart IDs.
- **Cohort IDs**: A list of the cohort IDs.

> **Warning:**
>
> User IDs, Chart IDs, and Cohort IDs list details for the counts in the previous three columns. As a result, these columns can exceed cell size limits in spreadsheets.

#### JSON fields and definitions

- **Event volume**: Total event volume ingested by Amplitude.
- **Query count**: Count of queries against an event when used in charts, cohorts, custom events.
- **Last\_seen**: Last date of event ingestion.
- **First\_seen**: First date of event ingestion.
- **Views**: Total number of views on charts and cohorts for an event.
- **Owners**: Current owners of a chart, cohort, or custom event.
- **Viewers**: Unique viewers for charts and cohorts.
