---
url: 'https://docs.codatum.com/features/notebook/chart/big-number.md'
description: A chart that displays a key indicator as text or a gauge
---

# Big Number

Big Number is a chart that displays a key indicator prominently. It aggregates a **metric** (required) and a **secondary metric** (optional) as metrics. In a gauge, the secondary metric becomes the gauge's maximum value.

## Drawing types {#drawing-types}

Big Number has two drawing types: **Text** and **Gauge**.

![BigNumber Text](/chart-capture/bignumber-text-light.png "Text"){.light-only .chart-capture}

![BigNumber Text](/chart-capture/bignumber-text-dark.png "Text"){.dark-only .chart-capture}

![BigNumber Gauge](/chart-capture/bignumber-gauge-light.png "Gauge"){.light-only .chart-capture}

![BigNumber Gauge](/chart-capture/bignumber-gauge-dark.png "Gauge"){.dark-only .chart-capture}

## Specification

### Aggregation {#aggregation}

Big Number [doesn't use a dimension; it aggregates the selected metric](./concept/dimension-metrics#dimension-metric) and displays it as a single value.

| Item {.nowrap} | Role | Notes |
| --- | --- | --- |
| **Metric** | Metric | Displays the aggregated result as a single value. |
| **Secondary metric** | Metric | In gauge mode, this becomes **Secondary metric (gauge max)** and is required. |

#### Examples

* Show "total sales" as text.
  * **Metric**: sum of sales.
* Show "achievement rate" as a gauge.
  * **Metric**: sum of actuals.
  * **Secondary metric (gauge max)**: sum of targets.

### Gauge specification {#gauge}

* The gauge's achievement rate (%) is calculated as "metric ÷ secondary metric × 100".
* The secondary metric is required and must be a numeric column.

## Tips

### Conditional formatting {#conditional-format}

In **advanced settings**, **conditional formatting** lets you change the font color based on the metric's value. For example, if the metric is an achievement rate, you can change the color to a danger color when it's 80 or below, and a success color when it's 100 or above.