Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Documention for v4 is still work in progress, and is incomplete

You can see documentation for v3 at /v3


Cal-Heatmap is a javascript library to create a calendar heatmap.

Star on Github View Examples

Day/Year Calendar Heatmap Day/Month Calendar Heatmap


  • Date locale and timezone support
  • Date Navigation
  • Various time granularity
  • Full color customisation
  • Animation
  • Extension via plugins

See the examples section

Browsers support


  • Google Chrome 95+
  • Mozilla Firefox 95+
  • Microsoft Edge 95+
  • Safari 14.1+


  • Google Chrome Android 7+
  • Samsung Internet Android 7+
  • Safari iOS 14+


Cal-Heatmap is distributed under the MIT Licence