How to create custom dimensions and metrics on Google Analytics

intermediate 8 min read Updated 2026-03-18
Quick Answer

Custom dimensions and metrics in Google Analytics 4 allow you to track specific data points unique to your business needs. You can create them through the Admin section by defining custom dimensions for qualitative data and custom metrics for quantitative measurements.

Prerequisites

  • Active Google Analytics 4 (GA4) property
  • Admin access to the Google Analytics account
  • Basic understanding of data tracking concepts
  • Website with Google Analytics tracking code installed

Step-by-Step Instructions

1

Access Google Analytics Admin Panel

Log into your Google Analytics account and navigate to the Admin section in the bottom left corner. Select the appropriate Account and Property from the dropdown menus to ensure you're working with the correct GA4 property.
Make sure you're using a GA4 property, not Universal Analytics, as the interface and options differ significantly.
2

Navigate to Custom Definitions

In the Property column, scroll down and click on Custom definitions. This section contains both Custom dimensions and Custom metrics options. You'll see a list of any existing custom definitions you've already created.
GA4 allows up to 50 custom dimensions and 50 custom metrics per property.
3

Create a Custom Dimension

Click Create custom dimension and fill out the required fields:
  • Dimension name: Enter a descriptive name (e.g., "User Type" or "Content Category")
  • Description: Add a clear description of what this dimension tracks
  • Event parameter: Enter the parameter name that matches your tracking code
  • Scope: Choose between Event, User, or Item scope based on your tracking needs
Click Save to create the dimension.
The event parameter name must exactly match what you're sending in your tracking code, including case sensitivity.
4

Create a Custom Metric

Click Create custom metric and configure the following:
  • Metric name: Enter a descriptive name (e.g., "Video Watch Time" or "Download Count")
  • Description: Describe what this metric measures
  • Event parameter: Enter the parameter name from your tracking implementation
  • Unit of measurement: Select from Standard, Currency, Distance, or Time
Click Save to create the metric.
Custom metrics should track numerical values only. Use custom dimensions for text-based or categorical data.
5

Implement Tracking Code

Update your website's tracking implementation to send the custom data. For custom dimensions, use:
gtag('event', 'page_view', {
  'custom_parameter_name': 'your_value'
});
For custom metrics, send numerical values:
gtag('event', 'video_complete', {
  'watch_duration': 120
});
Replace the parameter names with those you defined in GA4.
It can take 24-48 hours for custom dimensions and metrics to start appearing in your reports after implementation.
6

Verify Data Collection

Use the Realtime report in GA4 to verify your custom dimensions and metrics are being collected correctly. Go to Reports > Realtime and trigger the events on your website while monitoring the real-time data. You can also check the DebugView if you have debug mode enabled.
Enable Google Analytics Debugger extension in Chrome for easier troubleshooting during the testing phase.
7

Create Custom Reports

Navigate to Explore in the left sidebar and create a new exploration or custom report. Add your custom dimensions and metrics to the report by selecting them from the Dimensions and Metrics sections. Configure your report layout and apply any necessary filters to analyze your custom data effectively.
Custom dimensions and metrics also become available in the standard reports and can be used in audiences and conversions.

Common Issues & Troubleshooting

Custom dimension showing (not set) values

Check that your tracking code parameter name exactly matches the one defined in GA4. Verify the tracking code is firing correctly and sending data for all relevant events.

Custom metric not appearing in reports

Ensure you're sending numerical values for custom metrics, not text. Verify the event parameter name matches exactly, and wait 24-48 hours for data processing.

Data appears inconsistent or incomplete

Check your event scope settings - User scope applies to all events for that user, while Event scope only applies to specific events. Review your tracking implementation for consistency.

Cannot create more custom dimensions

GA4 has a limit of 50 custom dimensions per property. Review existing custom dimensions and delete unused ones, or consider combining similar dimensions into one with multiple values.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Google Analytics website before purchasing.