[UA] Create and edit custom dimensions and metrics

Custom dimensions and custom metrics are like default dimensions and metrics in your Analytics account, except you create them yourself. You can use them to collect and analyze data that Analytics doesn't automatically track.

Custom dimensions and metrics are set at the property level in an Analytics account. You must have the Editor role on the property to create or edit custom dimensions & metrics.

Creating either a custom dimension or metric is a two step process. First, set up the custom dimension or metric in your property. Then, modify your tracking code. You must complete these steps in order.

In this article:

Set up custom dimensions

  1. Sign in to Google Analytics.
  2. Click Admin, and navigate to the property to which you want to add custom dimensions.
  3. In the PROPERTY column, click Custom Definitions > Custom Dimensions.
  4. Click New Custom Dimension.
  5. Add a Name.
    This can be any string, but use something unique so it’s not confused with any other dimension or metric in your reports.
  6. Select the Scope.
    Choose to track at the Hit, Session, User, or Product level. Read more about scope and how custom dimensions are processed in our Developer Guide.
  7. Check the Active box to start collecting data and see the dimension in your reports right away. To create the dimension but have it remain inactive, uncheck the box.
  8. Click Create.

Set up custom metrics

  1. Sign in to Google Analytics.
  2. Click Admin, and navigate to the property to which you want to add custom metrics.
  3. In the PROPERTY column, click Custom Definitions > Custom Metrics.
  4. Click the New Custom Metric button.
  5. Add a Name.
    This can be any string, but use something unique so it’s not confused with another dimension or metric in your reports.
  6. From the Formatting Type dropdown, select an Integer, Currency, or Time.
    An integer can be any number. The currency type will match the view settings (i.e., USD, Yen, etc.) and should be entered as a decimal number. Specify time in seconds, but it appears as hh:mm:ss in your reports.
  7. Check the Active box to start collecting data and see the metric in your reports right away. To create the metric but have it remain inactive, uncheck the box.
  8. Click Create.

Modify your tracking code

After you create custom dimensions or metrics in your property, you must also modify your tracking code. This should be completed by a qualified developer. Follow the instructions in the Developer Guide for your specific environment:

Edit custom dimensions and metrics

Custom dimensions and metrics can’t be deleted once created, but you can return to these settings in your account to manage and edit them. To stop using an existing custom dimension, uncheck the Active box, and click Save.

Was this helpful?

How can we improve it?
true
Choose your own learning path

Check out google.com/analytics/learn, a new resource to help you get the most out of Google Analytics 4. The new website includes videos, articles, and guided flows, and provides links to the Google Analytics Discord, Blog, YouTube channel, and GitHub repository.

Start learning today!

Search
Clear search
Close search
Google apps
Main menu
1718487098955133547
true
Search Help Center
true
true
true
true
true
69256
false
false