# Application Data Table: Heatmap Cells Table

Feature usage matrix with weekday columns, value shaded cells, per row totals, and an intensity legend beneath the table.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/heatmap-cells-table
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Data Tables](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/heatmap-cells-table.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-data-tables-heatmap-cells-table
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, radix-ui
- shadcn/ui components: button, table
- Installs to: `@/components/blocks/application-pro/data-tables/heatmap-cells-table`

## About this block

Heatmap Cells Table is the feature usage matrix where
every numeric cell is shaded by its own value. Six
features run as rows (Dashboards, Reports, Alerts, API
explorer, Exports, and Integrations) against seven
weekday columns, and each session count sits inside a
rounded chip whose fill darkens with volume: transparent
under 25, then four steps up to a solid foreground fill
at 400 or more. A right-aligned Total column rolls up
each row, and an intensity legend runs from Fewer to More
below the grid so the shading has a key.

The rows are one typed array of value arrays and a single
intensity function maps each number to its Tailwind fill
and text class, keeping contrast readable at every step.
Totals are computed inline with reduce, and the whole
grid sits in an overflow-x-auto wrapper so the seven day
columns scroll on narrow viewports instead of crushing.

## When to use

Reach for this block whenever the shape of a two
dimensional grid matters more than any single number:
usage by feature and day, activity by hour and weekday,
or spend by team and month. The shading surfaces hot and
dead zones that a plain grid of digits hides, so scan
first and read exact counts second.

A natural flow around it on an Application Pro page:

**Before**

- [Stat cards](https://www.shadcn-ui-blocks.com/blocks/application-pro/stat-cards)
- [Charts](https://www.shadcn-ui-blocks.com/blocks/application-pro/charts)

**After**

- [Reports](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports)
- [Filters and search](https://www.shadcn-ui-blocks.com/blocks/application-pro/filters-and-search)

## What you can display

One strong use is feature usage by weekday. Other heatmap
grids:

- **Cohort retention.** Signup week as rows, weeks since
  as columns, darker cells marking stickier cohorts.
- **Traffic by hour.** Weekday rows against hour columns
  to find the daily peak at a glance.
- **Error density.** Service rows against day columns so
  a bad deploy shows as a dark vertical band.

> Tip: cap the scale at a sensible ceiling; one runaway
> cell can wash every other value to the palest step and
> flatten the pattern you built the grid to show.

## More in Application Data Tables

- [Audit Log Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/audit-log-table)
- [Column Visibility Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/column-visibility-table)
- [Comparison Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/comparison-table)
- [Csv Preview Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/csv-preview-table)
- [Dense Data Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/dense-data-table)
- [Density Toggle Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/density-toggle-table)
- [Diff Review Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/diff-review-table)
- [Editable Cells Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/editable-cells-table)
- [Empty State Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/empty-state-table)
- [Feature Flags Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/feature-flags-table)
- [Grouped Columns Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/grouped-columns-table)
- [Grouped Rows Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/grouped-rows-table)
- [Inline Edit Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/inline-edit-table)
- [Invoices Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/invoices-table)
- [Multi Select Toolbar Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/multi-select-toolbar-table)
- [Nested Detail Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/nested-detail-table)
- [Paginated Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/paginated-table)
- [Pinned Columns Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/pinned-columns-table)
- [Row Actions Menu Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/row-actions-menu-blueprint)
- [Search Highlight Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/search-highlight-table)
- [Selectable Bulk Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/selectable-bulk-table)
- [Sortable Header Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/sortable-header-table)
- [Sparkline Metrics Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/sparkline-metrics-table)
- [Status Summary Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/status-summary-table)
- [Sticky Footer Totals Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/sticky-footer-totals-table)
- [Sticky Header Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/sticky-header-table)
- [Table With Expandable Rows](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/table-with-expandable-rows)
- [Table With Filters](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/table-with-filters)
- [Timeline Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/timeline-table)
- [Tree Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/tree-table)
- [Users Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables/users-table)
