Stat card - Custral Docs

Overview

A Stat card reduces a whole object to one number: total deals, open tickets, average deal size, unique companies. It’s the KPI tile you put across the top of a dashboard so the headline is readable at a glance, before the charts below break it down.

When to use

A single number is the point: “how many”, “how much”, “what’s the average”.
As a dashboard’s top row of KPIs, paired with charts that explain the trend behind each number.

Configuration

Setting	What it does
Object	The records the stat is measured over (required).
Property	The property to aggregate. Leave blank to count records; required for Sum / Average / Min / Max.
Aggregation	How the number is computed: Count, Unique, Sum, Average, Min, or Max.

Scope the number with per-block filters, and connect a dashboard-level filter so the KPI moves with the rest of the board.

Limitations

Count and Unique ignore the Property; Sum / Average / Min / Max require a numeric Property, or the card reads 0 / blank.
A stat card is a point-in-time number, for a trend, pair it with a Sparkline or Line chart.

Troubleshooting

Symptom	Likely cause	What to check
The number is 0	No records match, or Sum / Average is set with no (or a non-numeric) Property	Check filters; pick a numeric Property for Sum / Average / Min / Max.
The number looks too high	Duplicate records inflate a Count	Try Unique on an identifying property.
The card doesn’t move with a dashboard filter	The dashboard filter isn’t linked to this block	Link the block to the dashboard-level filter.

Sparkline: the same measure as a compact trend.
Team performance: many per-teammate stats in one table.
Reporting overview

​Overview

​When to use

​Configuration

​Limitations

​Troubleshooting

​Related

Overview

When to use

Configuration

Limitations

Troubleshooting

Related