About custom dimensions and metrics

Custom dimensions and custom metrics are just like the default dimensions and metrics in your Analytics account, except that you create them yourself. They can be used to collect and analyse data that Google Analytics doesn't automatically track.

For definitions, examples and an illustration of how dimensions and metrics work together, read dimensions and metrics.

Using custom dimensions and metrics

Custom dimensions and metrics require additional setup in your Analytics account and in your development environment. Once you complete the setup, you can use them the same way that you use the default dimensions and metrics in your Analytics account.

Custom dimensions appear as primary dimensions in Custom reports. You can also use them in Segments. Custom metrics appear in Custom reports and in Segments.

Set up custom dimensions and metrics: An overview

Creating either custom dimensions and custom metrics is a two-step process. Use the links here to find the specific instructions that you need:

Step 1: Set up a new custom dimension or custom metric in your Analytics account.

This step requires Edit permission for a Google Analytics account.

From any page in your Analytics account, click Admin to set up a custom dimension & metrics via the account management interface.

Step 2: Implement a custom dimension or custom metric in your development environment.

This step requires technical knowledge and access to the source code; it should be completed by a developer.

Implement the new custom dimension or a custom metric following the environment-specific instructions in our developer guide. This link is also included at the end of the help centre instructions for setting up custom dimensions and metrics in your Analytics account.