KPI

KPI tiles highlight important metrics and key performance indicators. Rather than a single fixed layout, KPIs are row-based and composable — you build the tile by stacking blocks of different types, each configured independently.

​

Getting started

The KPI visualization starts with a Number block that compares the first and second rows of your result for the first numeric column. To add a new block, click the + button inside the visualization and choose the block type. To edit a block, click it in the visualization — the configuration panel updates to show that block’s settings. Reorder blocks by dragging the handle on the left side of each block. Delete a block with the trash icon in its configuration panel.

​

Block types

​

Number

Displays a single value from your query result. See Styling blocks below for font size, color, background, and alignment.

​

Comparison

Displays a current value alongside a previous value with a calculated difference. Use this to show period-over-period change or target vs. actual. See Styling blocks below for the positive/negative/neutral colors applied based on the direction of change. To compare to a static goal, add a column to your query that always returns the same number (e.g. a calculated field with a constant), then select it as the Previous field.

​

Progress bar

Shows a value relative to a target as a progress bar or circle. Useful for goal tracking. See Styling blocks below for background and alignment.

​

Sparkline

Renders a compact trend chart — either a bar or line — within the KPI tile. Use this to show the trend behind the headline number. See Styling blocks below for background and alignment.

​

Text

A Markdown-enabled text field for titles, headings, or descriptions within the tile. Supports standard Markdown formatting. Use text blocks for short labels and headings inside the KPI. For complex layouts with Markdown, use the HTML block or consider the Custom visualization instead.

​

HTML

A free-form HTML block rendered inside the KPI tile. Use this for advanced custom layouts that go beyond what the other block types support. See Styling blocks below for background and alignment.

​

Styling blocks

Every block has a Style panel with alignment controls — horizontal (left, center, right) and vertical (top, middle, bottom) — for positioning its content within the block’s space. Most block types also get a Background color, painted behind that block only; leave it unset to show the tile’s own background through. Some block types add colors of their own: Text blocks don’t have a background or color control — style them directly with Markdown/HTML.

​

Layout controls

KPI tiles have a layout panel that controls how blocks are arranged:

​

Converting to raw Markdown

If you need customization beyond what the block builder supports, you can convert the KPI visualization directly to Markdown by clicking on the Markdown visualization option.