'%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M0%2062.3176C0%2027.9001%2027.8995%200.00181961%2062.3134%200.00181961L62.3999%2062.2311C62.3999%2096.6462%2034.5004%20124.544%200.0852901%20124.544'%20fill='%233A3D3C'/%3e%3c/g%3e%3cpath%20d='M62.3994%2062.2461V0C96.8133%200%20124.713%2027.8982%20124.713%2062.3158'%20fill='url(%23paint0_linear_6331_3458)'/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M45.617%2026.2827C47.7276%2026.2827%2049.4382%2027.9933%2049.4382%2030.1052C49.4382%2032.2146%2047.7276%2033.9252%2045.617%2033.9252C43.5064%2033.9252%2041.7958%2032.2146%2041.7958%2030.1052C41.7958%2027.9933%2043.5064%2026.2827%2045.617%2026.2827Z'%20fill='%23F9F6EF'/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M45.6168%2045.2338C37.2596%2045.2338%2030.4857%2038.461%2030.4857%2030.1038C30.4857%2021.7454%2037.2596%2014.9702%2045.6168%2014.9702C53.9753%2014.9702%2060.7492%2021.7454%2060.7492%2030.1038C60.7492%2038.461%2053.9753%2045.2338%2045.6168%2045.2338ZM45.6168%2012.6686C35.9875%2012.6686%2028.1816%2020.4744%2028.1816%2030.1038C28.1816%2039.7308%2035.9875%2047.5378%2045.6168%2047.5378C55.245%2047.5378%2063.0508%2039.7308%2063.0508%2030.1038C63.0508%2020.4744%2055.245%2012.6686%2045.6168%2012.6686Z'%20fill='%23FECE01'/%3e%3cdefs%3e%3clinearGradient%20id='paint0_linear_6331_3458'%20x1='62.2719'%20y1='4.01754'%20x2='108.703'%20y2='70.5262'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%239ED5CB'/%3e%3cstop%20offset='1'%20stop-color='%23FCE18E'/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e)
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