This article is about Google Analytics 4 properties. Refer to the Universal Analytics section if you're still using a Universal Analytics property, which will stop processing data on July 1, 2023 (July 1, 2024 for Analytics 360 properties).

[GA4] Customize reports

This article is for property administrators who want to customize the contents of detail reports. If you want to customize overview reports, read this article instead.

You need the Editor role on the property to customize reports. Each property can have up to 200 custom reports.

Access the report builder

Click Customize report [Customize report] in the upper-right corner of any report OR

  1. In the left navigation, click Reports > Library (at the bottom of the left navigation). The report library on the bottom left of Google AnalyticsIf you don't see Library, you don't have Edit permission.
  2. Scroll down to the Reports table. 
  3. Click +Create new report and select "Create detail report"
    Hover your mouse over a report in the table and click More []. 
    Detail reports have the Type (second column in the table) "Detail report".
  4.  If you clicked More [] , click Edit or Make a copy from the drop-down menu. 
    • Edit allows you to edit the original report.
    • Make a copy preserves the original report and opens a copy for editing.

The report builder appears.

Customize the report

The report builder includes sections along the right side:

Once you finish making changes, click Save. An alert will notify you if any collections contain the report that you are modifying.

Report data

In this section, you choose the dimensions and metrics that appear in the report table. You can set default dimensions and metrics and custom dimensions and metrics in the report.

In the report builder, click Dimensions to control the list of primary dimensions that will be available in the table. For example, in the screenshot below, the Dimensions editor shows the dimensions Item name, Item ID, Item category, etc. You can use the Add dimension drop-down menu to choose and search for dimensions.

A screenshot of the Dimensions editor

Use the Dimensions editor to control the primary dimensions that are available in the report table drop down menu. See example screenshot, below.

Drag dimensions so that they appear in the order you want, remove and add dimensions, and Set as default the dimension that you would like to appear in the table by default. Click Apply to apply your changes and go back to the report builder.

In the report builder, click Metrics to control the list of metrics that will display (as columns) in the table. In the Metrics editor, drag metrics so that they appear in the order you want, and remove and add metrics. Click Apply to apply your changes and go back to the report builder.

Report filter

In this section, you can apply a filter to the report to see a subset of the data in the report. For example, you could apply a filter to show only the data from websites and hide data from mobile apps, or show data for only one country or region.

Anyone with access to a property can remove a filter at the top of a report temporarily, but Analytics adds the filter back when they leave the report.

To add a filter:

  1. Click + Add filter on the right of the detail report.
  2. In the filter builder, choose Include or Exclude to include or exclude data.
  3. In the Dimension drop-down, choose a dimension.
  4. In the Dimension Values field, choose one or more dimension values.
  5. Optional: Click Add new condition to create up to 4 more conditions.
  6. Click Apply.

To learn more about filters, see Apply filters to reports.


You can have up to two visualizations at the top of a detail report.

  • If you don't want one or both of the visualizations to appear, toggle one or both of them off.
  • Select the type(s) of visualization you want.
  • Drag a visualization to change which of the two visualizations appears first in the report.

Report template

To unlink or link (see Linked reports, below) a report, click Unlink/Link [unlink]. Unlinked objects cannot be linked in the future, once you save the report changes.

Summary cards

In this section of the report builder, you create cards that relate to this report. These cards can then be used to assemble overview reports. You can skip over the Summary Cards section if you don't want to create any cards for this report.

You won't see your summary cards reflected on the report. The cards you create become available to use in overview reports.

For each card you create, you must set at least one dimension, one metric, and one visualization. You can only select dimensions and metrics that are used in the detail report.

You can also apply a filter to a summary card to show a subset of the data in the related detail report. When you apply a filter to a summary card, anyone with access to the property can see that a filter has been applied to the card in the top right (see below). To learn more about filters, see Apply filters to reports.

An overview card with a filter applied

Linked reports

Linked objects (e.g. linked reports) receive updates from Google. For example, if Google adds a dimension to the User acquisition report, the dimension will automatically be added to all linked User acquisition reports.

Reports that you create from templates are linked by default and automatically receive updates.

Changes that you (or another administrator on the property) have made will not be impacted. For example:

  • Metrics or dimensions that you (or another property admin) have added or removed aren't impacted.
  • Charts (visualizations) that you (or another property admin) have added or removed aren't impacted.


If you don't want a report to receive updates, you can unlink it.

Objects (e.g. reports) that you create from scratch are unlinked by default.
To unlink a report, click Unlink [unlink] in the report builder. Unlinked objects cannot be linked in the future, once you save the report changes.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center