IBM Carbon-inspired calendar heatmap showing activity density by date across one or more calendar months. Data is a list of date-value pairs; cells are coloured by intensity across a configurable colour scale. Distinct from heatmap (arbitrary x/y grid) and github_activity_grid (year-spanning GitHub-specific format). Adapted from IBM Carbon AI Applications data visualisation patterns.
| Surface | Note |
|---|---|
| renders as a static colour grid; tooltips unavailable | |
| googlechat | renders as a plain text date-count list; no visual grid |
| Field | Type | |
|---|---|---|
| title | string. Heading above the calendar grid. | optional |
| data | array. List of {date, count} objects where date is "YYYY-MM-DD". | required |
| months | integer. Number of calendar months to render. Default 3. | optional |
| color_scale | array of strings. CSS colours from empty to maximum density. Default IBM Carbon blue scale. | optional |
| unit | string. Unit label appended to count in tooltips, e.g. "commits". | optional |
{
"type": "heatmap_calendar",
"data": [
{
"date": "2026-06-01",
"value": 5
},
{
"date": "2026-06-15",
"value": 12
}
]
}{
"identifier": "urn:air:a2uicatalog.ai:atom:heatmap_calendar",
"displayName": "Heatmap Calendar",
"type": "application/vnd.a2ui.atom+json",
"url": "https://a2uicatalog.ai/atoms/heatmap_calendar",
"capabilities": [
"web",
"meet-stage",
"pdf",
"apps-script-web"
],
"description": "IBM Carbon-inspired calendar heatmap showing activity density by date across one or more calendar months. Data is a list of date-value pairs; cells are coloured by intensity across a configurable colour scale. Distinct from heatmap (arbitrary x/y grid) and github_activity_grid (year-spanning GitHub-specific format). Adapted from IBM Carbon AI Applications data visualisation patterns.",
"representativeQueries": [
"show a calendar month heatmap with date-value density colouring",
"ibm carbon-inspired calendar heatmap showing activity density by date across one or more calendar mo",
"render a heatmap calendar"
]
}The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.
git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy