Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

What Is a Dimension?

A dimension is a categorical attribute used to break down your Measures and Metrics. Common examples include Region (North, South, East, West), Product Line (Enterprise, SMB, Consumer), Sales Channel (Direct, Reseller, Online), or Department.

Dimensions enable granular forecasting — instead of projecting total Revenue as a single number, you can forecast Revenue by Region, or by Product Line, or by both simultaneously. This lets your overlays target specific slices of your business (e.g., "increase Enterprise Revenue by 20% in the Western region").

Each dimension has a set of Dimension Values — the specific categories within that dimension. Dimension Values are shared across dimensions, so a value like "Sweden" can belong to both a Billing Country and a Shipping Country dimension.

Where dimension values come from:
  • Ingestion: values are discovered automatically from the distinct entries in your mapped dimension columns when a source is ingested.
  • Manual add: you can add a value directly, without touching your source data. Open the Dimensions page from the left navigation, find the dimension's card, and click Add Value — enter a display name and technical name (and an optional alias).

Adding a value manually is how you model a category that has no historical data yet — for example, a region you plan to launch in. Add the value on its dimension, then target it from an overlay: an Override block with a dimension filter scoped to the new value writes forecast rows for a slice the baseline knows nothing about.