> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcemedium.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Metric Columns

> How we name metric columns so they’re readable and consistent across the warehouse.

## Overview

A metric will always consist of an `entity` (e.g. order, customer), `dimension`, and in some cases, a `modifier`.
To make column names more human readable, our naming conventions will always keep the `entity` and the `metric` next to each other,
as the combination of the two represents the majority of what you’re looking for when locating a metric or typing a metric in a query.
From there, any relevant entity modifiers will appear before the metric, as this context is critical for understanding the meaning of the
`entity_metric` combination.

## Metric column name formula

`{{ modifier }}_{{ entity }}_{{ metric }}`

## Examples of metrics without modifiers

* `order_gross_revenue` where `order` is the `entity` and `gross_revenue` is the `metric`
* `order_net_revenue_before_refunds` where `order` is the `entity` and `net_revenue_before_refunds` is the metric

## Examples of metrics with modifiers

* `new_customer_order_net_revenue` where `order` is the `entity`, `net_order_revenue` is the `metric`, and `new_customer` modifies this `entity_metric` combination
* `repeat_customer_order_count` where `order` is the `entity`, `count` is the `metric`, and `repeat_customer` modifies this `entity_metric` combination