Glossary

Custom dimension

An attribute a site owner defines and sends to their analytics tool to capture data not tracked by default.

A custom dimension is a data attribute a site owner defines and sends to their analytics tool because it is not tracked by default — for example, a visitor's subscription tier, login status, or an article's author or category. It extends the platform's built-in dimensions, such as page path, device or traffic source, with attributes specific to that business.

Custom dimensions are typically implemented by pushing values into a data layer or passing them as parameters alongside an existing event tracking call or pageview, and are scoped to different levels depending on the platform — some apply to a single hit, others persist for a whole session or a whole user. This differs from a goal tracking configuration, which marks an action as significant; a custom dimension instead adds descriptive context that can be used to filter or segment any report, including goal and conversion reports.

Custom dimensions matter because they let teams answer business-specific questions a stock report cannot, such as comparing engagement between logged-in and anonymous visitors. The common pitfalls are running out of a platform's fixed dimension slots by defining overlapping or redundant dimensions, and skipping a documented tracking plan up front — without one, different teams often send inconsistent values for what is meant to be the same dimension, making the data unreliable to segment on later.

Last reviewed September 22, 2026

In the index now

Related terms