---
title: Heatgrid Widget
description: >-
  Compare timeseries data across many tag groups, with each group displayed as
  its own color-coded row.
breadcrumbs: Docs > Dashboards > Widgets > Heatgrid Widget
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Heatgrid Widget

{% image
   source="https://docs.dd-static.net/images/dashboards/widgets/heatgrid/heatgrid.6348b3aa1997429f3baa046fefc95ddd.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/heatgrid/heatgrid.6348b3aa1997429f3baa046fefc95ddd.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Example heatgrid widget visualization" /%}

The heatgrid widget displays timeseries data grouped by tag, with each group shown as its own row and values encoded by color. This makes it easier to spot changes and compare groups directly, even when the number of groups is high.

## Setup{% #setup %}

### Configuration{% #configuration %}

1. Configure your query, grouping by the tag you want to compare across rows. Each group in the query's results appears as its own row in the grid.
   {% image
      source="https://docs.dd-static.net/images/dashboards/widgets/heatgrid/heatgrid_colors.a591ea58f9d9e6c797d7d1d71963b05d.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/heatgrid/heatgrid_colors.a591ea58f9d9e6c797d7d1d71963b05d.png?auto=format&fit=max&w=850&dpr=2 2x"
      alt="Heatgrid configuration panel showing sort, row label width, legend, and color options." /%}
1. Sort rows by: Order rows by **average value**, **max value**, **min value**, **sum of values**, or **label**, in ascending or descending order.
1. Colors: Configure how query values map to row colors.
   - Scheme: Select a preset color scheme, or edit an individual stop's color or position in **Format stops** to customize it.
   - Apply as: Choose **Continuous Gradient** to map values along a smooth color scale, or **Discrete Conditions** to map value ranges to specific colors.
   - For a custom gradient, add stops along the scale and set a color and position (0-100%) for each.
   - For custom discrete conditions, define a color and a value range (lower and upper bound) for each condition. The first condition has no lower bound and the last has no upper bound, so together the conditions cover the full range of values. **Note**: The lower bound of the first bucket is the min value across the data and the upper bound of the last bucket is the max value.
   - Each gradient or set of discrete conditions supports 2-6 stops or conditions.
1. Row label width: Choose a specific width for the row label column, using preset sizes. By default, Datadog selects the size closest to the width of the labels in view.
1. Show legend label: Toggle to show or hide the legend label.

### Options{% #options %}

#### Unit override{% #unit-override %}

Configure units as they display in the grid and tooltips.

#### Context links{% #context-links %}

[Context links](https://docs.datadoghq.com/dashboards/guide/context-links.md) are enabled by default; you can toggle them on or off. Context links connect dashboard widgets with other pages (in Datadog or third-party).

## Further Reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Building Dashboards using JSON](https://docs.datadoghq.com/dashboards/graphing_json.md)