[UA] Create and edit custom dimensions and metrics [Legacy] (2024)

Custom dimensions and custom metrics are like default dimensions and metrics in your Analytics account, except you create them yourself. You canuse themto 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

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:

• Website tracking: For Universal Analytics (if using gtag.js)
• Mobile app tracking: For Android and iOS mobile apps

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.