Value

Configure a Value visualization in Toucan AI to highlight a single KPI with optional variation.

Target Audience: Non-technical users and builders configuring charts in the Library.

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.

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.

• Compare many categories → Bar chart.

• Row-by-row detail → Table.

• Share of a whole → Circular chart.

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, Manual Edit (how-to).

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 · Customize a chart manually · Create a chart with AI