> For the complete documentation index, see [llms.txt](https://docs.toucanai.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toucanai.cloud/build/charts/chart-types/value.md).

# Value

{% hint style="info" %}
**Target Audience**: Non-technical users and builders configuring charts in the Library.
{% endhint %}

<figure><img src="/files/CP1TJOm215Z3209iBFXN" alt="Value chart example"><figcaption></figcaption></figure>

## Overview

**Value** displays one main **KPI** in large type. An optional **Variation** metric can show change versus another period or segment (for example growth or a comparison value).

* **Value:** the primary column, with optional **Aggregation** and **Format number**.
* **Variation:** optional second column under *More options*, with its own aggregation and formatting.

There is no dimension axis — the editor shows **Value** at the top, then *More options* for **Variation**. In the **Library**, enable **Manual Edit**, set **Type** to **Value**, and map columns under **Data**.

Shared fields (**Title**, **Narrative**, **Data**) are in [Chart types](/build/charts/chart-types.md#shared-chart-level-settings).

## When to use it

**Good fit**

* One headline number (total revenue, active users, open tickets).
* A KPI with a **comparison** (vs last month, vs target) via **Variation**.
* Dashboard tiles where a chart would be too busy.

**Prefer another chart**

* Trend over time → [Line chart](/build/charts/chart-types/line-chart.md).
* Compare many categories → [Bar chart](/build/charts/chart-types/bar-chart.md).
* Row-by-row detail → [Table](/build/charts/chart-types/table.md).
* Share of a whole → [Circular chart](/build/charts/chart-types/circular-chart.md).

**Examples:** total revenue this quarter, active users with month-over-month variation, average deal size vs last quarter.

**Common setups**

* **Single KPI:** **Value** + **Aggregation** (e.g. Sum, Count distinct) + **Format number**.
* **KPI + comparison:** configure **Value**, then **Variation** under *More options*.

## Configuration options

Open the chart in the **Library**, turn on **Manual Edit**, select **Data**, then set **Type** to **Value**.

Prerequisites: [connected database](/build/data-connections/how-to/add-a-database.md), Manual Edit ([how-to](/build/charts/how-to/customize-a-chart-manually.md)).

### Value

| Option            | How it works                                                                                                   |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| **Value**         | Main KPI column. Often numeric; use **Aggregation** (e.g. Count rows) for other column types.                  |
| **Aggregation**   | Reduces rows before display (see below).                                                                       |
| **Format number** | Shown when the value is numeric (after aggregation). Standard, Percent, Currency, decimals, optional **Unit**. |

### More options

| Option        | How it works                                                                                                                           |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Variation** | Optional comparison column. Clear the selection to remove variation. Same **Aggregation** and **Format number** behavior as **Value**. |

**Aggregations on Value and Variation**

| Available                      | Not available in the editor |
| ------------------------------ | --------------------------- |
| Sum, Average, Minimum, Maximum | Cumulated sum               |
| Count rows, Count distinct     | Standard deviation          |

Availability still depends on the selected column type (same rules as other charts).

The AI assistant can pre-fill **Value** and **Variation**; use **Manual Edit** to adjust aggregation and formatting.

**Suggested next steps:** [Chart types](/build/charts/chart-types.md) · [Customize a chart manually](/build/charts/how-to/customize-a-chart-manually.md) · [Create a chart with AI](/build/charts/how-to/create-a-chart-with-ai.md)