Calendar heatmap

Use it for daily values over months, when weekday habits and single heavy days are the story. Shading is clipped at the 95th percentile so one huge day does not wash out the rest.

← All charts

Live demo

Made-up data. Try the options, then switch to the empty and one-point states.

Hover a day for its date and value; click to drill down. The calendar scrolls sideways on a phone.

How to use it

Paste the toolkit from Get the code into your page first, then call the chart like this.

JavaScript
const days = new Map([
  ['2026-01-01', 42.5],
  ['2026-01-02', 0],
  ['2026-01-03', 118.9]
  // ... one entry per day
]);

const chart = calendar({
  days,
  onClick: date => openDay(date),   // 'YYYY-MM-DD'
  label: 'Daily spending calendar'
});

Options

What you can pass to this chart.

days

A Map of 'YYYY-MM-DD' to number. Missing days inside the range count as zero.

onClick

(dateString) => void.

label

aria-label for the whole graphic.

Want charts or dashboards like these in your own product?

Tell me what you are trying to see and I can help work out the right approach, from the data behind it to the screen in front of people.