> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Heatmap Charts

> Create heatmap visualizations in Omni to display data density and patterns using color gradients across two-dimensional grids.

## Examples

**Heatmap:**

<img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/heatmap-bd416ba7768dc0e89e1495894be098f4.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=192446df82da60c0c18531d6da814d80" alt="" width="2298" height="1168" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/heatmap-bd416ba7768dc0e89e1495894be098f4.png" />

## Data Structures

Heatmaps can work with pivoted or unpivoted data, using 2 dimensions and one measure, or with all dimensions where there is a numeric available for the color facet. They often use two time facets, for example:

* `date` & `hour_of_day`
* `week` & `day_of_week`
* `month` & `year`

<img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/heatmap-data-8dc073731723e7601c211eec9bce3d34.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=d14adac2c3349e9b3124ab566722a6f4" alt="" width="1734" height="1150" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/heatmap-data-8dc073731723e7601c211eec9bce3d34.png" />

## Configuration

There is no heatmap specific configuration, but [color](/visualize-present/visualizations/configuration/color) and [tooltip](/visualize-present/visualizations/configuration/tooltips) controls may be relevant.

Heatmaps support gradient color scale value pins for the color field. You can pin specific minimum, midpoint, and maximum values for the color scale instead of using automatic data ranges. This is useful when you want to maintain consistent color mapping across multiple heatmaps or time periods.

For details on configuring gradient color scales, see [Gradient color scale values](/visualize-present/visualizations/configuration/color#gradient-color-scale-values).