> For the complete documentation index, see [llms.txt](https://learn.shapesxr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.shapesxr.com/places/heatmaps-feature.md).

# Heatmaps feature

Heatmaps provide a way to understand how people experience a space by capturing real user sessions in VR.

They make it possible to:

* **Analyze movement** — see how users navigate through a space.
* **Assess attention** — understand where users look and how long they focus on specific areas.
* **Validate design decisions** based on real interactions in context.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVe3WtaDajk6XtByQd1M6%2Fuploads%2Ft4XzMYdLPz86txDFpUNB%2FHeatmapping%20Luxury%20Store%20Places%20-%20Trim.mp4?alt=media&token=e35a7add-9cdc-4745-9940-dde2f123ff8c>" %}

Heatmaps are recorded as **holonotes (without audio)** that capture:

* User movement and position.
* Object interactions.
* Gaze direction over time.

Each session becomes a replayable record of the user experience, providing detailed insight into how a space is explored and used.

### **Enabling Heatmaps**

To start recording heatmaps, enable this option for a Place in the [**Web Arranger**](/places/places-dashboard/web-arranger.md).

<figure><img src="/files/oMpRDgoHZCWLuIq09CRN" alt=""><figcaption></figcaption></figure>

Once enabled, **recording starts automatically when a user enters the Place in VR**.\
All sessions will be captured and grouped by variants.

***

### **Reviewing Recordings**

Recorded heatmaps can be viewed in the **Web arranger** in different modes:

* **Observer view** — watch the session from the outside
* **First-person view** — see the experience from the user’s perspective

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVe3WtaDajk6XtByQd1M6%2Fuploads%2FU6Gmv1oMBUUjmdgKcTkt%2FGIF2.mp4?alt=media&token=89f3c8f7-6179-45df-ae57-a1ce47d771fe>" %}

\
Attention is visualized using a **color gradient**, showing how long a user focused on specific areas, for example: green - short attention, but red — long, sustained focus.

***

### **Managing Recordings**

The Web Arranger also provides the possibility to organize and manage recordings:

* **Rename** heatmaps.
* **Delete.**

<figure><img src="/files/6Sd9FEVsp0x1cJ1qEOEu" alt=""><figcaption></figcaption></figure>