Widgets

A widget is a single tile on a dashboard: a number, a chart, a table, a funnel, and so on. You build one by picking a source event, choosing a type, configuring it, and giving it a title. A live preview shows the result as you go, so you can see exactly what the tile will look like before you save it.

Adding a widget

Metric widgets

Metric is the workhorse type. You pick an event, a measure, optionally a breakdown, and optionally plot the result over time. Those choices decide whether you end up with a single number, a time series, or a breakdown.

Measures

The measure is the maths applied to the matching events.

For example, on the purchase event: count tells you how many purchases happened, sum of an amount property gives you total revenue, and avg of amount gives you the average order value. uniq on a string property like country tells you how many distinct countries bought something.

Breakdown

A breakdown groups the measure by one property, giving you one bar or one line per value instead of a single combined number.

• A string property groups normally. Break purchase down by an item property and you get one bar per item.
• A list (array) property explodes, so each value in the array counts separately. If an event has perks: ["double_jump", "shield"], it counts toward both double_jump and shield, so one event can appear under more than one bar or series.

Only string and list properties can be a breakdown. You cannot break down by a number.

Over time

Toggle "over time" to add a time axis and watch the measure change across the dashboard's range. count of player_join over time becomes a line or area chart of joins per bucket.

Combine a breakdown with over time and you get a multiseries chart: one line or set of bars per breakdown value, plotted across time. For example, joins over time broken down by map gives you one series per map.

Chart types by shape

The combination of breakdown and over time settles on a shape, and each shape offers its own set of chart types:

The counter delta

A counter (and each item in a KPI row) also shows how it changed against the immediately preceding window of the same length. If the dashboard is on the 24h range, the counter compares the last 24 hours with the 24 hours before that, and shows the difference as a delta.

The delta is hidden when the previous window was zero, so you never see a meaningless jump from nothing.

Filters

Filters narrow a widget down to matching events. Each filter is a property key, an operator, and a value. Add more than one and they combine with AND, so an event has to match every filter to be counted.

For example, map eq desert combined with mode eq ranked shows only ranked matches on the desert map.

Display options

Once the data shape is set, these options control how it is drawn.

• Goal / target: on a stat, renders progress toward a number. Point a revenue stat at a 10000 goal and it shows how close you are.
• Y-axis: pinned to zero by default, or fit to the data's own range for line, area, and bar charts. Fitting to range makes small movements easier to see; pinning to zero keeps the scale honest.
• Stacking (multiseries): stacked (the default), 100% stacked, or overlaid. Stacked shows the total and each series' contribution, 100% stacked shows each series as a share of the whole, and overlaid draws them on the same baseline for direct comparison.
• Legend: placed at the bottom or on the right side, and optionally showing the value next to each label.

Layout and limits

• Size: use the sm, md, and lg presets, or set a custom column span from 2 to 12 on the grid. Picking a preset clears any custom span you set.
• Per-widget menu: each tile has a menu with Edit, Rename, Duplicate, "Alert on this" (metric widgets only), width presets, move earlier or later, and remove.
• Breakdown limit: breakdowns keep only the top labels by value (10 by default) unless the widget sets its own limit, so a chart with hundreds of values stays readable.
• Table cap: tables are capped at 100 rows.

Widget types

Each type has its own page with the full set of settings.