Overview
The Heatmap Viewer shows you exactly where learners are tapping on a specific step screen. It takes the percentage you see in the Lessons Dashboard and turns it into a visual picture, so you can see not just that learners made mistakes, but where and why.
How to Access It
From the Lessons Dashboard, select any colored step cell in the grid. The Heatmap Viewer opens in a new tab and shows the screen replica for that step.
What You Will See
The Heatmap Viewer shows the lesson name and step name at the top of the page. The screen replica appears in the center, displaying the actual screen a learner would have seen during that step.
On the left side, the Step Description panel shows the instruction the learner was given for that step. This is the same instruction that appeared in the lesson when the learner attempted it. Reading the Step Description alongside the screen helps you understand what learners were asked to do and whether the instruction was clear enough to guide them to the right place.
The Green Outline
A green outline appears on the screen replica around the correct control — the specific button, icon, or element the learner was supposed to tap. This is the target action for that step.
Any tap that lands inside the green outline is a correct action. Any tap that lands outside the green outline is an incorrect action and is counted in the error data you see in the Lessons Dashboard.
The Dots
Dots appear on the screen showing where learners actually tapped. Each dot represents one or more tap locations recorded during learner attempts.
Dots inside the green outline show correct taps. Dots outside the green outline show where learners tapped instead of the correct control. A cluster of dots in the wrong area can tell you a lot — for example, learners may be tapping a nearby element that looks similar, or they may be misreading the instruction.
Filtering by Timespan
The Timespan dropdown at the top left lets you control which time period the dot data reflects. The options are 30 Days, 60 Days, 90 Days, Year to Date, All Time, and Custom. Selecting Custom activates the Start Date and End Date fields so you can define a specific range.
Filtering by timespan is useful when you want to see whether a content update changed learner behavior. For example, you can compare dot patterns before and after a lesson was revised.
Filtering by Mode
The Practice and Knowledge Check toggles in the bottom right corner let you control which learning modes are included in the dot data. Both are on by default. You can turn either off to focus on a specific mode.
How to Use This Data
Start by reading the Step Description to understand what learners were asked to do. Then look at where the dots appear in relation to the green outline.
If most dots are inside the green outline, learners are finding the correct control. If dots are clustered in the wrong area, consider whether the instruction is directing learners clearly, whether another element on the screen is drawing their attention, or whether the correct control is easy enough to find.
Use what you see to decide whether the lesson content, the step instruction, or the screen design needs to be updated.
Closing the Heatmap Viewer
Select Close at the bottom left of the page to close the Heatmap Viewer and return to the previous view.
What's Next
Now that you know how to use all five tools in the Lessons Dashboard series, you have everything you need to find problem steps, understand why learners are struggling, and make targeted improvements to your content.