# Metric Explorer (Beta)

> 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`.

Use Metric Explorer to:

- Compare event-based and session-based measurements side by side on the same chart, for example, Add to Carts and Sessions over time.
- Build and visualize hybrid formulas that combine event and session inputs in one expression, for example, Revenue per Session or Add to Carts per Session.
- Apply advanced per-metric measurements (rolling average, rolling window, cumulative) to any metric type.
- Run cross-metric analyses in a single chart instead of switching between Segmentation and User Sessions.

Metric Explorer covers nearly all capabilities of both the [Segmentation](https://amplitude.com/docs/analytics/charts/event-segmentation/event-segmentation-build) chart and the [User Sessions](https://amplitude.com/docs/analytics/charts/user-sessions/user-sessions-track-engagement-frequency) chart, making it the ideal starting point for all segmentation and session analyses. Amplitude offers it as a separate chart in beta while the remaining gaps close.

## Before you start

- Enable sessions for your project. Refer to [Track sessions](https://amplitude.com/docs/data/sources/instrument-track-sessions).
- Hybrid formula metrics combine event and session inputs in one expression. Refer to [Hybrid formula metrics](#hybrid-formula-metrics) for how to add them in Metric Explorer.

## Create a Metric Explorer chart

To build a Metric Explorer chart, follow these steps:

1. Click **+ New Chart** and select **Metric Explorer (Beta)** from the chart picker.
2. In the metrics panel, click **+ Add metric** and pick an event, a session metric, a saved metric, or a hybrid formula. You can add multiple metrics of different types to the same chart.
3. To group your results, click **+ Group by**. When at least one metric on the chart is session-scoped, the group-by selector offers event, session, or chart-level scoping. Refer to [Group-by scoping](#group-by-scoping).
4. To filter the population, add **Segments**, or pick a saved segment from Segments V2.
5. Choose a time range and an interval (real-time, hourly, daily, weekly, monthly, or quarterly).
6. Choose a visualization (line, bar, stacked area, stacked bar, pie, or KPI) from the visualization picker.

## Not yet supported

> **Note:** Updated regularly
>
> Amplitude updates this list as remaining capabilities ship.

- **Horizontal bar chart**: horizontal bar charts display as a single chart (similar to vertical bar charts); separate horizontal charts in a single table view aren't supported, and the relative/absolute toggle supports absolute values only.
- **Custom X axis**
- **Save metric** (coming soon)
- **Duration selector / counting in**

## Group-by scoping

When at least one metric on the chart is session-scoped, the **Group by** selector offers a scoping control with three options:

- **Event**: Amplitude evaluates the group-by on the event row that satisfies the metric.
- **Session**: Amplitude evaluates the group-by on the session that contains the event.
- **Chart-level**: Amplitude applies the group-by uniformly across all metrics on the chart.

For event-only metrics on a chart that also contains session metrics, scoping defaults to **Event**. The same scoping rules apply in Metric Explorer as in Data Tables. For the full reference, refer to [Use session metrics in Data Tables](https://amplitude.com/docs/analytics/charts/data-tables/data-tables-use-session-metrics#choose-event-level-or-session-level-group-bys-for-session-metrics).

## Hybrid Formula metrics

Hybrid Formulas combine event and session inputs in one expression. Metric Explorer is one of the surfaces where Hybrid Formulas work. To add one:

1. Click **+ Add metric**, then **Create metric**, then **Hybrid Formula**.
2. Add event inputs and session inputs, then write the expression, for example, `A / S`.
3. To reuse the metric across other Metric Explorer charts and Data Tables, save it.

For the support matrix, common examples, and the measurement reference, refer to [Hybrid Formulas](https://amplitude.com/docs/analytics/charts/metric-explorer/hybrid-formulas).

## FAQ

### Do existing Segmentation and User Sessions charts keep working?

Yes. Amplitude offers Metric Explorer as a separate chart, so existing charts and dashboards keep working unchanged.

### Can I save a Metric Explorer chart to a dashboard?

Yes. You can save Metric Explorer charts and add them to dashboards, and Metric Explorer supports Replace Events on dashboards.

### Can I export a Metric Explorer chart?

Yes. Export CSV is available in Metric Explorer.

### How do I report a bug or request a capability?

Use the in-product feedback widget, or talk to your customer success manager.
