Source: https://docs.amadalis.ai/insights/reporting-dimensions/

# Add a reporting dimension

Use **Copilot** in the site admin as an Editor or Admin when you need to group a report by something this site already records. Review the saved definition under **Insights** > **Analytics** > **Measures**. A dimension supplies the grouping, such as a recorded event property. It does not collect new data.

Checked against the product’s code on 7 November 2026.

## Choose the recorded source

A dimension can read an event property, a supported event column, a visitor trait from their first arrival, the calendar day or audience membership. Ask the copilot to check the recorded source before defining it.

Decide how its values should be offered:

-   A fixed set of named values appears as selectable chips. Supply the complete allowed set.
-   Identifiable records use a searchable picker.
-   An open set of values needs a stated number of leading values whenever it groups a report.

## Add the definition

1.  Open **Copilot** in the site admin. The conversation is ready for your request.
2.  Ask it to inspect the recorded source you want to group by. Check that the property, trait or other supported source exists.
3.  Type “Add a new reporting dimension called \[label\], reading \[recorded source\], with the new stable key \[key\]. Its values are \[value choice\].” Replace the brackets with the real source and your choice above. Use a new lowercase key with underscores between words.
4.  Choose **Send**. The definition saves without an approval card; the result names the dimension and its version.
5.  Open **Insights** > **Analytics**. The reporting tabs appear.
6.  Open **Measures**. Find the dimension by its label and check its meaning.
7.  Ask **Copilot** to break a recorded measure down by this dimension. For an open set, include how many leading values to show. Read the grouped result.

[![Measures shows the saved dimension's name, what it groups and where its values come from.](https://docs.amadalis.ai/images/steps/2026-11-05-coverage-and-stale/COV1-14-dimension-definition-1440.png)](https://docs.amadalis.ai/images/steps/2026-11-05-coverage-and-stale/COV1-14-dimension-definition-1440.png "Open full-size image")

The dictionary entry shows where the saved dimension's values come from.

[![Copilot confirms the new dimension by name and offers Undo.](https://docs.amadalis.ai/images/steps/2026-11-05-coverage-and-stale/COV1-14-dimension-receipt-1440.png)](https://docs.amadalis.ai/images/steps/2026-11-05-coverage-and-stale/COV1-14-dimension-receipt-1440.png "Open full-size image")

The copilot confirms the saved dimension.

A successful definition is available for breakdowns immediately. A report can still have no rows if no matching data has been recorded.

## Change or undo it

Use a new key for a new grouping. Updating an existing definition can change its version and restate saved reporting views under the new meaning. Platform dimensions cannot be overwritten.

The copilot receipt’s **Undo** removes a new definition or restores the one it replaced. Read the result before relying on it after later changes. See [Reporting groupings](https://docs.amadalis.ai/reference/copilot/analytics-and-events/#reporting-groupings) for the request. For the reporting workflow, follow [Analytics reports and sources](https://docs.amadalis.ai/insights/analytics-reports-and-sources/).

## Your next step

Ask **Copilot** to group a recorded measure by your saved dimension, including how many leading values to show when needed. Use [Reports, sources and funnels](https://docs.amadalis.ai/insights/analytics-reports-and-sources/) to review the reporting view.