Heatmap Report

Who can use this feature?
 User Types
Any user with access to Explore (Global Admins, Area Admins, and some Users) can edit a Heatmap Report. All users can view a Heatmap Report.
Available on paid plans (AnalystCLO, and Enterprise).
Anybody (both beginners and experts) can use this feature.

What is a Heatmap Report?

The Heatmap Report provides an ideal way to quickly compare activity between learners. Like the Leaderboard Report, each Heatmap Report shows text-based data, but also presents a visual representation of your learners’ activities by using varying intensities of color. Darker and lighter backgrounds on cells are used to visually highlight outlier values. For instance, if you are looking at test scores for a group of learners, you can easily identify higher performers because their corresponding colors would be darker.heatmap_general.png

Creating and Editing a Heatmap Report

Use Explore to create new Heatmap Reports and to configure existing Heatmap Reports.

Heatmap Report Filters and Options

Beyond the typical Explore filters and options, the Heatmap Report provides options that are unique to the Heatmap Report.

Heatmap Filter

When setting up a new Heatmap Report or configuring an existing Heatmap Report, click Heatmap in the filter menu:heatmapheatmap.png

In the Heatmap filter, you’ll choose what you’d like to rank (using the Organized menu), how you’d like to rank it (using the Measures menu), whether you want to show data values in addition to the heatmap colors (using the Value Labels menu), and how to scale the heatmap colors (with Scale Colors).


On the Organized menu, you’ll choose what you’d like to rank on the Heatmap. Choose an option from the Organized menu and the rows on the Heatmap will be what you’ve chosen.

For example, if you choose By Person in the Organized menu, your Heatmap will be organized by people (each row will be a person): 


On the Measures menu, you’ll choose which measures you’d like to rank what you chose in the Organized menu. You can choose multiple measures for the same Heatmap Report, and each measure you choose is given a column in the Heatmap Report.

 Related: What are Measures?

For example, if you choose By Person in the Organized menu, each of the measures you choose in the Measures menu will be represented as columns on the Heatmap, and each block of the Heatmap would show how people performed on the measures you selected. In the below example, the measures chosen are Average Score and Total Time:

To add a measure to the Heatmap, choose a measure from the Select a Measure menu and click the Add Measure button next to the menu. You’ll see the measure added to the Heatmap, and the measure will be added to the Measures section. To deselect a measure, click the X next to the Measure in the Measures section.

Value Labels

In Value Labels menu, you'll choose whether you want the actual numbers to appear on your Heatmap or if you want to let your users decide whether to see the actual numbers.

If you choose Always Hide, no numbers will show on your Heatmap:

If you choose Always Show, numbers will show on your Heatmap:

If you choose Select in UI, your users can decide whether they want to see Heatmap values with a toggle on the Heatmap:

Scale Colors

In the Scale Colors menu, you'll choose whether you want the colors of your heatmap to scale across all of the measures of the heatmap or whether you want the colors to scale within each measure.

If you choose Across All Measures, the color scale for the Heatmap will be set to the highest value across all measure values:Screen_Shot_2018-01-28_at_2.15.29_PM.png

If you choose By Individual Measures, each measure will have it's own color scale. Each measure's color scale will be determined by the highest value across each measure:Screen_Shot_2018-01-28_at_2.15.11_PM.png

Advanced Configuration

 Advanced configuration is designed to be used by expert users who understand JSON and the properties of xAPI statements.

Whether or not values are shown can also be configured in Advanced Configuration.



Example values


Whether or not to show values on heatmap grid squares.




If show values is null, the report viewer will be able to select whether or not to show values in the UI, without having to use Explore.

Check out our Advanced Configuration guide for more information.

Was this article helpful?
1 out of 1 found this helpful


1 comment
  • Heatmaps have turned out to be really powerful for us. Is there a limit to the number of columns in a heatmap?

Please sign in to leave a comment.

If you can't find what you need or you want to ask a real person a question, please contact customer support.