Category: Charts
Renders a graphical representation of data where individual values
| Field | Type | Required |
|---|---|---|
| data | list of lists of numbers (e.g., [[1, 2, 3], [4, 5, 6]]) | required |
| labels_x | list of strings (labels for the x-axis, e.g., ['Mon', 'Tue', 'Wed']) | required |
| labels_y | list of strings (labels for the y-axis, e.g., ['AM', 'PM']) | required |
| color_scale | list of strings (colors for the gradient, e.g., ['#FFFFFF', '#FF0000'] for white to red) | required |
| unit | string (optional, unit for the data values, e.g., '°C') | optional |
| z_min | number (optional, value drawn with the first colour of the scale; default the smallest value) | optional |
| z_max | number (optional, value drawn with the last colour; default the largest value) | optional |
| z_mid | number (optional, value drawn with the middle of the scale, for diverging data; the colour range becomes symmetric around it; ignored when z_min and z_max are both given) | optional |
| scale | string (optional, a Plotly colour scale name - Viridis, Cividis, Blues, Greens, Reds, Greys, YlGnBu, YlOrRd, RdBu, Bluered, Picnic, Rainbow, Portland, Jet, Hot, Blackbody, Earth or Electric; default Viridis, or color_scale when that is given) | optional |
| show_colorbar | boolean (optional, default true, draws the colour bar with the lowest and highest value) | optional |
| show_values | boolean (optional, default false, prints each value inside its cell) | optional |
| value_format | string (optional, how values print - an optional comma for thousands, optional .N decimals, then f, % or d; for example ',.1f' or '.0%') | optional |
| version | integer (optional, default 1; a higher number draws as version 1 with a muted note) | optional |
{
"type": "heatmap",
"data": 1,
"labels_x": [
"Category A",
"Category B",
"Category C",
"Category D"
],
"labels_y": [
"Low",
"Medium",
"High"
],
"color_scale": [
"#3b82f6",
"#10b981",
"#f59e0b",
"#ef4444"
]
}{
"identifier": "urn:air:a2uicatalog.ai:atom:heatmap",
"displayName": "Heatmap",
"type": "application/vnd.a2ui.atom+json",
"url": "https://a2uicatalog.ai/atoms/heatmap/",
"capabilities": [
"web",
"google-meet-stage",
"google-apps-script-web",
"mcp-apps",
"android"
],
"description": "Renders a graphical representation of data where individual values",
"representativeQueries": [
"show a grid heatmap coloured by intensity value are represented as colors in a matrix",
"renders a graphical representation of data where individual values",
"render a heatmap"
]
}The renderer is an open-source Google Apps Script web app. 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 a2ui/apps-script-surface/gas-wired-renderer
clasp push && clasp deploy