Bars List - Custral Docs

A bars list ranking categories in a compact row layout.

When to use

A bars list answers “which categories are biggest?” as a compact, scannable ranking: leads by source, deals by owner, tickets by tag. Each row is a category with a horizontal bar sized by its value, sorted highest-first. Reach for it over a Bar chart when vertical space is tight (a narrow dashboard column or side panel) or when the ranking order matters more than a precise axis.

Required data shape

Group: a categorical property (select, status, owner…) whose values become the rows.
Value (optional): a numeric property aggregated per row; defaults to a record count.

Configuration

Setting	What it does
Group by	The property whose values become the ranked rows.
Aggregation	How each row’s value rolls up: Count or Sum.

Limitations

Best for a bounded set of categories, a high-cardinality property (e.g. a record id) produces an unreadable list.
Sum needs a numeric Value property; with Count, the Value is ignored.

Troubleshooting

Symptom	Likely cause	What to check
The list is empty	No records match, or the group property is unset on every record	Check the block’s filters and that the property has values.
Every bar is the same length	Aggregation is Count and each category has one record	Switch to Sum over a numeric property, or expect equal bars.
A blank / “Unknown” row dominates	Many records have no value for the group property	Fill the property, or filter out empty values.

Bar chart: the same data with a full axis.
Reporting overview

​When to use

​Required data shape

​Configuration

​Limitations

​Troubleshooting

​Related

When to use

Required data shape

Configuration

Limitations

Troubleshooting

Related