Cells matrix
Clusters across two sets of categories.
Definition · Updated Nov 2, 2026
A cells matrix crosses two sets of categories, such as topic and request size, and colours each cell by its cluster, faded where it is sparse, so the busy combinations stand out. Use it for requests by topic and size, tickets by product and severity, or any two-way count.
Pay once. Every update included.
Live preview
Sample data: requests across 16 topics in code, support, search and agents, by size from 128 to 16K, one cell marked at 1,284
- Data shape
- A cluster colour and dense or sparse per cell
- Good for
- Topic by size, product by severity
- Avoid when
- One of the axes is time
- Sizes
- XS, S, M and L, re-laid out from the data
Anatomy
Inspect it like the Figma file.
The same layers, names and tokens as the component. Select one to read its size, fill and style.
Layers
027 / Cells matrix
- Layer
- cell 4k · 6
- Type
- Rectangle
- Size
- 41 × 30
- Fill
- data/cat-3
- Radius
- 3
- Group
- Marks · 45
Layers
027 / Cells matrix
- Layer
- cell 4k · 6
- Type
- Rectangle
- Size
- 23 × 20
- Fill
- data/cat-3
- Radius
- 3
- Group
- Marks · 45
Layers
027 / Cells matrix
- Layer
- cell 4k · 6
- Type
- Rectangle
- Size
- 13 × 17
- Fill
- data/cat-3
- Radius
- 3
- Group
- Marks · 45
Sizes
Re-laid out, never scaled.
The same data at XS, S, M and L. Every size is redrawn from the data, so text and line weights never shrink.
M against S
Width360 px480 px
Plot328 px440 px
Labels99
Marks4545
Height212 px246 px
Same tokens at every size: text styles, 1 px lines and mark radius stay put.
When to use
Which combinations are busy.
Three signs it fits, and three signs another type fits better.
Is it counts, not a link?
Correlations between items.
Yes: Keep the cells matrix
Code and Figma
One name in Figma and in code.
Every Figma property is a prop with the same name and values. One command installs it.
Figma
chart/027-cells-matrix
npx shadcn add @chartory/cells-matriximport { CellsMatrix } from "@/components/chartory/cells-matrix"import { requestsByTopic } from "./requests-by-topic"export function RequestsByTopic() { return ( <CellsMatrix data={requestsByTopic} size="m" legend={true} /> )}Hearth widget
Cells matrix as a widget.
The chart in a Hearth card with a hero number and two blocks. One token set, light and dark.
EmberPreset
ChartoryDefault preset
Pick the blocks, the size and the preset for your own widget.
Read the Hearth widget docsFAQ
Cells matrix questions.
What people ask before they put a cells matrix in a dashboard.
Something else?
hello@usechartory.comRequest sizes grow in doubles (128, 256 … 16K), so each row covers a size band of the same ratio.
The cell under the crosshair (1,284 req in the sample); the others read by fill. The legend names the four topic groups.
One data object in the sample’s shape: a cluster colour and dense or sparse per cell. The docs page lists every field and links its JSON Schema; the sample data comes with the component, so you can start from it and swap in your own.
Series take the preset’s data colours in order, and states such as up, down or warning take its status colours. Change the preset in Figma or in code to recolour every chart at once.
XS, S, M and L, in light and dark. Each size is laid out again from the data, so text and lines keep their size.
Yes. It plays in when it scrolls into view, and when the data changes every mark moves from its old place to its new one. With reduced motion on, it does not move.
Yes. The React component is free in the public registry in Hearth, no token needed; Signal comes with Code and Complete. The Figma component comes with Figma and Complete.
Ask for it by name. The MCP server tells the agent what data it needs and runs the same command: npx shadcn add @chartory/cells-matrix. You review the diff.
Related types
Other ways to show relationship.
The same question, a different shape of answer. Every type ships in Figma and in code.
Same family
Relationship
17 types in Chartory answer this question.