---
title: "Calendar Heatmap panel plugin for Grafana"
description: "Shows a calendar heatmap panel similar to GitHub contribution graphs. Calendar Heatmap panel plugin for Grafana by tim012432."
---

> This is the Markdown version of https://grafana.com/grafana/plugins/tim012432-calendarheatmap-panel/

# Calendar Heatmap

- Developer: tim012432
- Version: 1.2.1
- [Installation](https://grafana.com/grafana/plugins/tim012432-calendarheatmap-panel/installation.md)
- [Change log](https://grafana.com/grafana/plugins/tim012432-calendarheatmap-panel/changelog.md)

![Theme Light with Color Orange](https://grafana.com/api/plugins/tim012432-calendarheatmap-panel/versions/1.2.1/images/img/demo-light.png)

![Theme Dark with Color Green](https://grafana.com/api/plugins/tim012432-calendarheatmap-panel/versions/1.2.1/images/img/demo-dark.png)

![Theme Tron with Color Blue](https://grafana.com/api/plugins/tim012432-calendarheatmap-panel/versions/1.2.1/images/img/demo-tron.png)

![Configuration Options](https://grafana.com/api/plugins/tim012432-calendarheatmap-panel/versions/1.2.1/images/img/demo-configuration.png)

![Calendar Heatmap Panel logo](https://github.com/tim0-12432/calendar-heatmap-panel/raw/main/src/img/logo.svg)

# Calendar Heatmap Panel

Turn raw time-series data into an instantly readable, GitHub-style activity calendar. Calendar Heatmap Panel makes trends, spikes, and gaps obvious at a glance—perfect for dashboards built for action.

---

## Visual showcase

![Calendar Heatmap Panel light theme](https://github.com/tim0-12432/calendar-heatmap-panel/raw/main/src/img/demo-light.png)

![Calendar Heatmap Panel dark theme](https://github.com/tim0-12432/calendar-heatmap-panel/raw/main/src/img/demo-dark.png)

![Calendar Heatmap Panel configuration](https://github.com/tim0-12432/calendar-heatmap-panel/raw/main/src/img/demo-configuration.png)

## Why teams love it

- **GitHub-style calendar visualization** makes activity patterns immediately obvious.
- **Eight color schemes** (Green, Blue, Red, Yellow, Purple, Orange, Custom, Custom Gradient) to match your brand or dashboard theme.
- **Seven aggregation methods** (Sum, Count, Average, Maximum, Minimum, First, Last) to capture the story behind your data.
- **Auto-sizing cells with theme-aware rendering** for beautiful, responsive dashboards.
- **Interactive tooltips** for fast, precise inspection of any day.
- **Fully customizable layout** with control over cell size, spacing, labels, and legends.

## Quick start

1. Install **Calendar Heatmap Panel** from the Grafana plugin catalog (recommended), or via Grafana CLI (`grafana-cli plugins install tim012432-calendarheatmap-panel`).
2. Add the panel to any dashboard with time-series data.
3. Choose an aggregation method and color scheme.
4. Adjust cell size, spacing, labels, and legend to match your layout.

You’ll have a calendar-style heatmap in minutes—no custom code required.

## Common use cases

- **DevOps & SRE**: visualize incident frequency, deploy cadence, and alert volume over time.
- **Data Analysts**: reveal seasonal trends, usage spikes, or churn patterns day by day.
- **Business Users**: highlight customer activity, revenue signals, or engagement streaks.
- **Operations**: track daily throughput, compliance checks, or support load.

## Configuration highlights

- **Color schemes**: quickly switch between eight curated palettes (Green, Blue, Red, Yellow, Purple, Orange, Custom, Custom Gradient).
- **Aggregation**: summarize values as Sum, Count, Average, Maximum, Minimum, First, or Last.
- **Layout controls**: tune cell size, spacing, and corner radius.
- **Labels & legend**: show week/month labels and legend for clarity.
- **Tooltips**: give viewers precise daily values on hover.

For the full configuration reference, including all display, label, data, and interaction options, see the [documentation on GitHub](https://github.com/tim0-12432/calendar-heatmap-panel#%EF%B8%8F-configuration-reference).

## Support and links

- **Source repository**: <https://github.com/tim0-12432/calendar-heatmap-panel>
- **Issues & feature requests**: <https://github.com/tim0-12432/calendar-heatmap-panel/issues>
- **Documentation**: <https://github.com/tim0-12432/calendar-heatmap-panel>

---

Make your Grafana dashboards instantly understandable with a calendar heatmap designed for real-world operational insights.
