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 Google Analytics doesn't automatically track.

Custom dimensions and metrics are set at the property level in a Google Analytics account. You must have Edit permission 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. Select the Admin tab and navigate to the property to which you want to add custom dimensions.
  3. In the PROPERTY column, click Custom Definitions, then click 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. Select the Admin tab and navigate to the property to which you want to add custom metrics.
  3. In the PROPERTY column, click Custom Definitions, then 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.

How helpful is this article:

Feedback recorded. Thanks!
  • Not at all helpful
  • Not very helpful
  • Somewhat helpful
  • Very helpful
  • Extremely helpful