Dimensions and metrics

Set up or edit custom dimensions & metrics

This feature is only available for properties using Universal Analytics. Learn how to set up Universal Analytics or upgrade from Classic Analytics to Universal Analytics.

Custom dimensions and metrics are set at the property level in a Google Analytics account. You must have edit permission to create or edit custom dimensions & metrics.

Creating custom dimensions or metric is a two step process. When you're done setting them up in your account property following the instructions in this article, you must also modify your tracking code to collect and send data to your account. Refer to the Next Steps below for more information.

Set up custom dimensions

  1. Sign in your Google Analytics account. Click Admin from the menu bar at the top of the page.
  2. From the dropdown menus, select an account and a property you want to add custom dimensions to.
  3. Under the Property column, click Custom Definitions, then 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, or User 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 your Google Analytics account. Click Admin from the menu bar at the top of the page.
  2. From the dropdown menus, select an account and a property you want to add custom metrics to.
  3. Under Property 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.

Next steps

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.