> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bars List

> Ranked categories as a compact horizontal bar list.

<Frame caption="A bars list ranking categories in a compact row layout.">
  <img src="https://mintcdn.com/custral/NGCdls_pt-1YDx5S/images/charts/bars-list.png?fit=max&auto=format&n=NGCdls_pt-1YDx5S&q=85&s=80a154c49f74231c054336bf7088fbb8" alt="A bars list ranking categories in a compact row layout." width="760" height="420" data-path="images/charts/bars-list.png" />
</Frame>

## 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](/bi/reporting/charts/bar) 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.               |

## Related

* [Bar chart](/bi/reporting/charts/bar): the same data with a full axis.
* [Reporting overview](/bi/reporting/overview)


## Related topics

- [Chart drill-down](/bi/reporting/drill-down.md)
- [Reporting](/bi/reporting/overview.md)
- [Bar Chart](/bi/reporting/charts/bar.md)
- [Radial Bar Chart](/bi/reporting/charts/radial-bar.md)
- [Blocks](/blocks/overview.md)