Repository: DataDog/documentation
Pull request #28966: [DOCS-10675] Update Heatmaps snapshot user experience in RUM and PA
Author: login: rtrieu
Labels: name: editorial review
description: Waiting on a more in-depth review
name: Images
description: Images are added/removed with this PR
name: mergequeue-status: done
Created: 2025-04-24T19:55:34Z | Merged: 2025-04-29T19:58:45Z

<!-- *Note: Please remember to review the Datadog Documentation [Contribution Guidelines](https://github.com/DataDog/documentation/blob/master/CONTRIBUTING.md) if you have not yet done so.* -->

### What does this PR do? What is the motivation?
<!-- A brief description of the change being made with this pull request. What is your motivation for the PR? -->
The user experience for changing the background/snapshot in Heatmaps within RUM and PA has changed slightly. This update reflects that change.

### Merge instructions

<!-- 
If you're waiting for a release or there are other considerations that you want us to be aware of, list them here. 
If the PR is ready to be merged once it receives the required reviews, check the box below after you've created the PR.
-->

Merge readiness:
- [x] Ready for merge

**For Datadog employees**:
Merge queue is enabled in this repo. Your branch name MUST follow the `<name>/<description>` convention and include the forward slash (`/`). Without this format, your pull request will not pass in CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

To have your PR automatically merged after it receives the required reviews, add the following PR comment:

```
/merge
```

### Additional notes
<!-- Anything else we should know when reviewing?-->

<!-- Previewing the PR: Assuming you are a Datadog employee and named your branch `<yourname>/<description>`, a preview build will run and links to the preview output will be auto-generated and posted in the PR comments. The links will 404 until the preview build is finished running. -->



Diff:
diff --git a/content/en/product_analytics/heatmaps.md b/content/en/product_analytics/heatmaps.md
index b3c90a33b11..7eb7ced7ff5 100644
--- a/content/en/product_analytics/heatmaps.md
+++ b/content/en/product_analytics/heatmaps.md
@@ -14,12 +14,12 @@ further_reading:
 All features in Product Analytics are in limited availability. To request access, complete the form.
 {{< /callout >}}
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v2.png" alt="An overview of the heatmap functionality." style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-landing.png" alt="An overview of the heatmap functionality." style="width:100%;">}}
 
 A heatmap (or heat map) is a visualization of your user's interactions overlaid on Session Replay data. Product Analytics has three different types of heatmaps:
 
 - **Click maps:** View user interactions (clicks) to understand how users engage with your page
-- **Top Elements:** View a ranking of up to the top 10 most interacted-with elements on a given page.
+- **Top elements:** View a ranking of up to the top 10 most interacted-with elements on a given page.
 - **Scroll maps:** View how far users scroll down a page, including where the average fold of a page falls. The average fold is the lowest point on a page that a user can see on their device without scrolling.
 
 Use heatmaps to review complex data at a glance, gaining insights around optimizing your user experience.
@@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click on a view name to have a more detailed look of the related heatmap. From here, you have these additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+{{< img src="product_analytics/heatmaps/pa-heatmaps-annotated.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+## Top Elements
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:60%;">}}
+Top Elements heatmaps aggregate click actions on a given view by displaying the elements that are most interacted with, in addition to their interaction rank. The ranking on the map itself corresponds to the action name on the side.
 
-Each Click map also offers analytics such as:
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
 
-- Where that page ranks out of all other visited pages
-- Unique user counts to that page
-- Any frustration signals on that page
+Hover over any action name in the panel to highlight the corresponding action on the map.
 
-Below the panel are all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
+## Click maps
 
-- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
-- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
+A Click map shows you the actions most interacted with on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
 
-{{< img src="real_user_monitoring/heatmaps/actions.jpeg" alt="Shows an example action and the information you can get about that action." style="width:60%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-clickmaps.png" alt="Clickmap data overlayed on a website." style="width:100%;">}}
 
-## Top Elements
+On the left is a list of all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
 
-Top Elements heatmaps aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
+- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
+- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
 
-{{< img src="real_user_monitoring/heatmaps/top-elements-v3.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
+From this view, you can also click the **Start a Funnel** button to identify user drop off.
 
-Click any action name in the panel to highlight the corresponding action on the map.
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-clickmap-actions.png" alt="Shows an example action and the information you can get about that action." style="width:50%;">}}
 
 ## Scroll maps
 
 Scroll maps show a visual of the aggregate scroll activity on a given page. Use Scroll maps to see where the average fold of the page falls, and how many users scroll to a given depth. You can drag the floating blue bar on a Scroll map to the depth you wish to assess.
 
-{{< img src="real_user_monitoring/heatmaps/scrollmaps-v3.png" alt="Scrollmap of the bedding page in a sample ecommerce application" style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-scrollmap.png" alt="Scrollmap of the bedding page in a sample ecommerce application" style="width:100%;">}}
 
 The panel to the left of the Scroll map provides high-level insights with direct links to query results, such as a link to a list of views where the user scrolled past a given percentile. Below the insight panel is a minimap of the page and a distribution graph displaying granular scroll data, useful for identifying where the biggest drop-off occurs.
 
-{{< img src="real_user_monitoring/heatmaps/scrollmaps-insights-panel.png" alt="A screenshot of the queries for scroll data insights" style="width:50%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-minimap.png" alt="A screenshot of the queries for scroll data insights" style="width:50%;">}}
+
+## Snapshots
+
+A snapshot is the state of a Session Replay at a particular point in time. Changing the snapshot shows different results, depending on the snapshot selected. You can use the **Change Snapshot** button to select a particular snapshot in a replay for your heatmap.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Change Snapshot** button.
 
-## Backgrounds
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-button.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different snapshot for your heatmap.
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-list-all-events.png" alt="List of action events for the session replay." style="width:100%;">}}
 
-A heatmap's list of backgrounds cannot be modified.
+1. If the session [does not contain the action](#the-view-that-i-selected-is-not-showing-the-initial-content) that leads to the desired snapshot, you can return to the list of replays by clicking **Choose Another Replay**.
+1. Click the **Select Snapshot** button to apply the snapshot at the paused point to the heatmap.
 
 ## Next steps
 
@@ -101,15 +112,15 @@ Heatmaps are based on Product Analytics view names. Depending on how your Produc
 
 ### The view that I selected is not showing the initial content.
 
-Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm smartly picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the [background](#backgrounds) of your heatmap, you can use the **Choose Background** button to navigate through the different states of the page and find the one you are looking for.
+Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the snapshot of your heatmap, you can use the **Change Snapshot** button to navigate through the different states of a replay and find the one you are looking for. If the replay you're viewing does not have the snapshot you're looking for, you can use the **Choose Another Replay** button to select another replay of the same view.
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-background-selector.mp4" alt="Select a different background via the choose background button" video=true >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4" alt="Select a different background by clicking the Change Snapshot button" video=true >}}
 
-### On the action list on the side of my heatmap, I see an icon showing an element that is not visibile in the heatmap.
+### On the action list on the side of my heatmap, I see an icon showing an element that is not visible in the heatmap.
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-hidden-elements.png" alt="Hidden elements in the action list on a heatmap." style="width:60%;">}}
+The tooltip on the icon says element is not visible. This means that the element is a common action on your page, but it's not displayed on the snapshot in the heatmap. To see that element, you can click **Change Snapshot** in the top right corner to switch the snapshot of your heatmap to one where that element is present.
 
-The tooltip on the icon says **element is not visible**. This means that the element is a common action on your page, but it's not displayed on the background in the heatmap. To see that element, you can click **Choose Background** in the bottom right corner to switch the background of your heatmap to one where that element is present. 
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-hidden-elements.png" alt="Hidden elements in the action list on a heatmap." style="width:100%;">}}
 
 ### After attempting to create a heatmap, I see a "No Replay Data" state appear. 
 
diff --git a/content/en/real_user_monitoring/session_replay/heatmaps.md b/content/en/real_user_monitoring/session_replay/heatmaps.md
index 3a01f47c13d..e04c7166184 100644
--- a/content/en/real_user_monitoring/session_replay/heatmaps.md
+++ b/content/en/real_user_monitoring/session_replay/heatmaps.md
@@ -15,7 +15,7 @@ further_reading:
   text: 'Visualize user interactions with your pages by using Scrollmaps in Datadog Heatmaps'
 ---
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v2.png" alt="An overview of the heatmap functionality." style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-landing.png" alt="An overview of the heatmap functionality." style="width:100%;">}}
 
 A heatmap (or heat map) is a visualization of your user's interactions overlaid on Session Replay data. Real User Monitoring (RUM) has three different types of heatmaps:
 
@@ -30,8 +30,8 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later).
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
@@ -39,56 +39,65 @@ To get started with heatmaps:
 
 Navigate to [**Digital Experience > Real User Monitoring > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. Under Map Type, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. Clicking one of these options takes you to the [heatmap page][2] for a particular view.
+On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. To the left of the timeframe selector, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. This takes you to the [heatmap page][2] for a particular view.
 
-{{< img src="real_user_monitoring/heatmaps/rum-heatmaps-getting-started.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
- You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+You have the following additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+## Top Elements
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+Top Elements heatmaps aggregate click actions on a given view by displaying the elements that are most interacted with, in addition to their interaction rank. The ranking on the map itself corresponds to the action name on the side.
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
 
-Each Click map also offers analytics such as:
+Hover over any action name in the panel to highlight the corresponding action on the map.
 
-- Where that page ranks out of all other visited pages
-- Unique user counts to that page
-- Any frustration signals on that page
+## Click maps
 
-Below the panel are all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
+A Click map shows you the actions most interacted with on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
 
-- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
-- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
-
-{{< img src="real_user_monitoring/heatmaps/actions.jpeg" alt="Shows an example action and the information you can get about that action." style="width:60%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-clickmaps.png" alt="Clickmap data overlayed on a website." style="width:100%;">}}
 
-## Top Elements
+On the left is a list of all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
 
-Top Elements aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
+- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
+- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
 
-{{< img src="real_user_monitoring/heatmaps/top-elements-v3.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
+From this view, you can also click the Start a Funnel button to identify user drop off.
 
-Click any action name in the panel to highlight the corresponding action on the map.
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-clickmap-actions.png" alt="Shows an example action and the information you can get about that action." style="width:50%;">}}
 
 ## Scroll maps
 
 Scroll maps display the aggregate scroll activity on a given page. Use Scroll maps to see where the average fold of the page falls, and how many users scroll to a given depth. You can drag the floating blue bar on a Scroll map to the depth you wish to assess.
 
-{{< img src="real_user_monitoring/heatmaps/scrollmaps-v3.png" alt="Scrollmap of the bedding page in a sample ecommerce application" style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-scrollmap.png" alt="Scrollmap of the bedding page in a sample ecommerce application" style="width:100%;">}}
 
 The panel to the left of the Scroll map provides high-level insights with direct links to query results, such as a link to a list of views where the user scrolled past a given percentile. Below the insight panel is a minimap of the page and a distribution graph displaying granular scroll data, useful for identifying where the biggest drop-off occurs.
 
-{{< img src="real_user_monitoring/heatmaps/scrollmaps-insights-panel.png" alt="A screenshot of the queries for scroll data insights" style="width:50%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-minimap.png" alt="A screenshot of the queries for scroll data insights" style="width:50%;">}}
+
+## Snapshots
+
+A snapshot is the state of a Session Replay at a particular point in time. Changing the snapshot shows different results, depending on the snapshot selected. You can use the **Change Snapshot** button to select a particular snapshot in a replay for your heatmap.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Change Snapshot** button.
 
-## Backgrounds
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-button.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different snapshot for your heatmap.
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-list-all-events.png" alt="List of action events for the session replay." style="width:100%;">}}
 
-A heatmap's list of backgrounds cannot be modified.
+1. If the session [does not contain the action](#the-view-that-i-selected-is-not-showing-the-initial-content) that leads to the desired snapshot, you can return to the list of replays by clicking **Choose Another Replay**.
+1. Click the **Select Snapshot** button to apply the snapshot at the paused point to the heatmap.
 
 ## Next steps
 
@@ -102,15 +111,15 @@ Heatmaps are based on RUM view names. Depending on how your RUM application is c
 
 ### The view that I selected is not showing the initial content.
 
-Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm smartly picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the [background](#backgrounds) of your heatmap, you can use the **Choose Background** button to navigate through the different states of the page and find the one you are looking for.
+Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the snapshot of your heatmap, you can use the **Change Snapshot** button to navigate through the different states of a replay and find the one you are looking for. If the replay you're viewing does not have the snapshot you're looking for, you can use the **Choose Another Replay** button to select another replay of the same view.
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-background-selector.mp4" alt="Select a different background via the choose background button" video=true >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4" alt="Select a different background by clicking the Change Snapshot button" video=true >}}
 
-### On the action list on the side of my heatmap, I see an icon showing an element that is not visibile in the heatmap.
+### On the action list on the side of my heatmap, I see an icon showing an element that is not visible in the heatmap.
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-hidden-elements.png" alt="Hidden elements in the action list on a heatmap." style="width:60%;">}}
+The tooltip on the icon says element is not visible. This means that the element is a common action on your page, but it's not displayed on the snapshot in the heatmap. To see that element, you can click **Change Snapshot** in the top right corner to switch the snapshot of your heatmap to one where that element is present.
 
-The tooltip on the icon says **element is not visible**. This means that the element is a common action on your page, but it's not displayed on the background in the heatmap. To see that element, you can click **Choose Background** in the bottom right corner to switch the background of your heatmap to one where that element is present. 
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-hidden-elements.png" alt="Hidden elements in the action list on a heatmap." style="width:100%;">}}
 
 ### After attempting to create a heatmap, I see a "No Replay Data" state appear.
 
diff --git a/static/images/product_analytics/heatmaps/heatmaps-pa.png b/static/images/product_analytics/heatmaps/heatmaps-pa.png
deleted file mode 100644
index 820d943b463..00000000000
Binary files a/static/images/product_analytics/heatmaps/heatmaps-pa.png and /dev/null differ
diff --git a/static/images/product_analytics/heatmaps/pa-heatmaps-annotated.png b/static/images/product_analytics/heatmaps/pa-heatmaps-annotated.png
new file mode 100644
index 00000000000..f2d8be40b6e
Binary files /dev/null and b/static/images/product_analytics/heatmaps/pa-heatmaps-annotated.png differ
diff --git a/static/images/product_analytics/heatmaps/pa-heatmaps-page.png b/static/images/product_analytics/heatmaps/pa-heatmaps-page.png
new file mode 100644
index 00000000000..1a866c09ece
Binary files /dev/null and b/static/images/product_analytics/heatmaps/pa-heatmaps-page.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-app-and-map.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-app-and-map.png
new file mode 100644
index 00000000000..399c7d39092
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-app-and-map.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-button.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-button.png
new file mode 100644
index 00000000000..68b33408271
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-button.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot.mp4 b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot.mp4
new file mode 100644
index 00000000000..de119b27b44
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot.mp4 differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4 b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4
new file mode 100644
index 00000000000..d2013899645
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4 differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmap-actions.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmap-actions.png
new file mode 100644
index 00000000000..77bddef5a7e
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmap-actions.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmaps.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmaps.png
new file mode 100644
index 00000000000..2772e0f897d
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-clickmaps.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png
new file mode 100644
index 00000000000..948922e2aa5
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-hidden-elements.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-hidden-elements.png
new file mode 100644
index 00000000000..5022f12377c
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-hidden-elements.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-landing.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-landing.png
new file mode 100644
index 00000000000..65c9c8b42ac
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-landing.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-list-all-events.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-list-all-events.png
new file mode 100644
index 00000000000..11325d411ff
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-list-all-events.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-minimap.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-minimap.png
new file mode 100644
index 00000000000..2095c6d1966
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-minimap.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-scrollmap.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-scrollmap.png
new file mode 100644
index 00000000000..745df151a19
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-scrollmap.png differ
diff --git a/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png
new file mode 100644
index 00000000000..3389405110d
Binary files /dev/null and b/static/images/real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png differ


Reviews:
user: login: abhi-motgi
state: CHANGES_REQUESTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-24T21:05:40Z
user: login: rtrieu
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-24T21:08:11Z
user: login: rtrieu
body: add abhi feedback as suggestions
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-24T21:15:31Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:21:28Z
user: login: rtrieu
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:24:13Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:27:43Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:28:57Z
user: login: rtrieu
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:29:25Z
user: login: rtrieu
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-28T21:30:10Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:05:34Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:07:57Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:11:16Z
user: login: iadjivon
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:14:58Z
user: login: iadjivon
body: Hi Rosa, 
Made some small edits. Let me know what you think!
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:20:17Z
user: login: iadjivon
body: All set!
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T19:31:20Z

Review comments:
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: A snapshot is the state of a replay at a particular point in time. Changing the snapshot shows different results depending on the snapshot selected. You can use the **Change Snapshot** button to select a particular snapshot in a replay for your heatmap.
created_at: 2025-04-24T20:54:39Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: ## Snapshots
created_at: 2025-04-24T20:54:57Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: Remove
created_at: 2025-04-24T20:55:17Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: **Choose Snapshot** --> **Change Snapshot**
created_at: 2025-04-24T20:55:44Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-zoomed.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different background for your heatmap.
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: Click an action event on the right to select a different snapshot for your heatmap.
created_at: 2025-04-24T20:56:36Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-zoomed.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different background for your heatmap.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-list-of-events.png" alt="List of action events for the session replay." style="width:100%;">}}
+
+1. If the session does not contain the action that leads to the desired snapshot, you can return to the list of replays by clicking **Choose Another Replay**.
+1. Click the **Select Snapshot** button to apply the snapshot at the paused point to the heatmap.
 
 ## Next steps
 
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: current:
### The view that I selected is not showing the initial content.
Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm smartly picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the [background](#backgrounds) of your heatmap, you can use the **Choose Background** button to navigate through the different states of the page and find the one you are looking for.



proposed: (also remove the outdated mp4 for now with the old change background UI)
### The view that I selected is not showing the initial content.
Heatmaps are generated with Session Replay data. Datadog’s intelligent algorithm smartly picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the [snapshot](#snapshots) of your heatmap, you can use the **Change Snapshot** button to navigate through the different states of a replay and find the one you are looking for. If the replay you’re viewing does not have the snapshot you’re looking for, you can use the **Choose Another Replay** button to select another replay of the same view.
created_at: 2025-04-24T21:01:25Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-zoomed.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different background for your heatmap.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-list-of-events.png" alt="List of action events for the session replay." style="width:100%;">}}
+
+1. If the session does not contain the action that leads to the desired snapshot, you can return to the list of replays by clicking **Choose Another Replay**.
+1. Click the **Select Snapshot** button to apply the snapshot at the paused point to the heatmap.
 
 ## Next steps
 
path: content/en/product_analytics/heatmaps.md
user: login: abhi-motgi
body: current:
### On the action list on the side of my heatmap, I see an icon showing an element that is not visibile in the heatmap.
(image)
The tooltip on the icon says **element is not visible**. This means that the element is a common action on your page, but it's not displayed on the background in the heatmap. To see that element, you can click **Choose Background** in the bottom right corner to switch the background of your heatmap to one where that element is present. 

proposed: (note the 'visible' spelling)
### On the action list on the side of my heatmap, I see an icon showing an element that is not visible in the heatmap.
(image)
The tooltip on the icon says element is not visible. This means that the element is a common action on your page, but it’s not displayed on the snapshot in the heatmap. To see that element, you can click **Change Snapshot** in the top right corner to switch the snapshot of your heatmap to one where that element is present.
created_at: 2025-04-24T21:03:24Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: ```suggestion
A snapshot is the state of a Session Replay at a particular point in time. Changing the snapshot shows different results, depending on the snapshot selected. You can use the **Change Snapshot** button to select a particular snapshot in a replay for your heatmap.
```
created_at: 2025-04-24T21:08:10Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: ```suggestion
```
created_at: 2025-04-24T21:08:22Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: ```suggestion
1. From the heatmap view, click the **Change Snapshot** button.
```
created_at: 2025-04-24T21:08:32Z
author_association: CONTRIBUTOR
diff_hunk: @@ -85,9 +85,21 @@ The panel to the left of the Scroll map provides high-level insights with direct
 
 ## Backgrounds
 
-A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the background selected. You can use the **Choose Background** button to select a particular background for your heatmap.
+A background is a snapshot of a Session Replay. Each heatmap fetches the 20 backgrounds that triggered the most actions during a given session. Changing the background shows different results depending on the action event selected. 
 
-A heatmap's list of backgrounds cannot be modified.
+**Note**: A heatmap's list of backgrounds cannot be modified.
+
+To select a background snapshot:
+
+1. From the heatmap view, click the **Choose Snapshot** button.
+
+   {{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-snapshot-zoomed.png" alt="Click the Change Snapshot button to change the background snapshot the heatmap is based on." style="width:100%;">}}
+1. Click an action event on the right to select a different background for your heatmap.
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: ```suggestion
1. Click an action event on the right to select a different snapshot for your heatmap.
```
created_at: 2025-04-24T21:08:56Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click a view to see a more detailed view of the heatmap. From here, you have the additional view options:
path: content/en/product_analytics/heatmaps.md
user: login: iadjivon
body: ```suggestion
Click on a view name to have a more detailed look of the related heatmap. From here, you have these additional view options:
```
There's a lot of the word `view` in the sentence and referring to slightly different UI items at time? 
The "view" to click on is  referenced as `view name` in the UI, so wanted to keep the consistency. Unless we want to refer to it as `the row of available views`
- "click on a selected row of available view" ?
- or the edit above
- or an edit you think makes more sense
created_at: 2025-04-28T21:21:28Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click a view to see a more detailed view of the heatmap. From here, you have the additional view options:
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: I do like this suggestion, thanks!
created_at: 2025-04-28T21:24:12Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click a view to see a more detailed view of the heatmap. From here, you have the additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+{{< img src="product_analytics/heatmaps/pa-heatmaps-annotated.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+## Top Elements
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:60%;">}}
+Top Elements heatmaps aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
path: content/en/product_analytics/heatmaps.md
user: login: iadjivon
body: ```suggestion
Top Elements heatmaps aggregate click actions on a given view by displaying the elements that are most interacted with, in addition to their interaction rank. The ranking on the map itself corresponds to the action name on the side.
```
This worked well as it was, but I made the modification because of any possible issues with translation for "most interacted-with". If you do not believe this would be an issue, please ignore this edit. 
created_at: 2025-04-28T21:27:42Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click a view to see a more detailed view of the heatmap. From here, you have the additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+{{< img src="product_analytics/heatmaps/pa-heatmaps-annotated.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+## Top Elements
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:60%;">}}
+Top Elements heatmaps aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
 
-Each Click map also offers analytics such as:
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
 
-- Where that page ranks out of all other visited pages
-- Unique user counts to that page
-- Any frustration signals on that page
+Hover over any action name in the panel to highlight the corresponding action on the map.
 
-Below the panel are all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
+## Click maps
 
-- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
-- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
+A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
path: content/en/product_analytics/heatmaps.md
user: login: iadjivon
body: same comment here with "interacted-with" as above. 
created_at: 2025-04-28T21:28:57Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click a view to see a more detailed view of the heatmap. From here, you have the additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+{{< img src="product_analytics/heatmaps/pa-heatmaps-annotated.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+## Top Elements
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:60%;">}}
+Top Elements heatmaps aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: I made a minor edit to your suggestion, but generally agree!
created_at: 2025-04-28T21:29:25Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,65 +29,76 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later)
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
-Navigate to [**Digital Experience > Product Analytics > Heatmaps**][2]. Select your application and view.
+Navigate to [**Digital Experience > Product Analytics > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Product Analytics landing page][3], select your application and view. You can select the type of heatmap you would like to view as well (Top Elements, Click Map, Scroll Map).
+From this page, you can select the type of heatmap (Top Elements, Click Map, Scroll Map) you would like to see for a particular view.
 
-{{< img src="product_analytics/heatmaps/heatmaps-pa.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="product_analytics/heatmaps/pa-heatmaps-page.png" alt="For each view, you can select a different type of heatmap: Top Elements, Click Map, or Scroll Map." style="width:100%;">}}
 
-This takes you to the [heatmap page][2] for a particular view. You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+Click on a view name to have a more detailed look of the related heatmap. From here, you have these additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+{{< img src="product_analytics/heatmaps/pa-heatmaps-annotated.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+## Top Elements
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:60%;">}}
+Top Elements heatmaps aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
 
-Each Click map also offers analytics such as:
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
 
-- Where that page ranks out of all other visited pages
-- Unique user counts to that page
-- Any frustration signals on that page
+Hover over any action name in the panel to highlight the corresponding action on the map.
 
-Below the panel are all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
+## Click maps
 
-- The number of times the user performed the action and where it falls in overall analytics of top actions on a given page.
-- If that action had a frustration signal occurring on it (for example, if a user rage clicked on that button), you can view the associated frustration signals as well.
+A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
path: content/en/product_analytics/heatmaps.md
user: login: rtrieu
body: ```suggestion
A Click map shows you the actions most interacted with on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
```
created_at: 2025-04-28T21:30:10Z
author_association: CONTRIBUTOR
diff_hunk: @@ -30,65 +30,74 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later).
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
 Navigate to [**Digital Experience > Real User Monitoring > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. Under Map Type, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. Clicking one of these options takes you to the [heatmap page][2] for a particular view.
+On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. To the left of the timeframe selector, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. This takes you to the [heatmap page][2] for a particular view.
 
-{{< img src="real_user_monitoring/heatmaps/rum-heatmaps-getting-started.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
- You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+You have the following additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+## Top Elements
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+Top Elements aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
path: content/en/real_user_monitoring/session_replay/heatmaps.md
user: login: iadjivon
body: ```suggestion
Top Elements heatmaps aggregate click actions on a given view by displaying the elements that are most interacted with, in addition to their interaction rank. The ranking on the map itself corresponds to the action name on the side.
```

Copied the edit you made in Product Analytics for this section
created_at: 2025-04-29T19:05:34Z
author_association: CONTRIBUTOR
diff_hunk: @@ -30,65 +30,74 @@ Use heatmaps to review complex data at a glance, gaining insights around optimiz
 To get started with heatmaps:
 
 1. Verify your SDK version:
-  - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
-  - For Scroll maps, you must be on (v4.50.0 or later).
+   - For Click maps, you must be on the latest version of the SDK (v4.40.0 or later).
+   - For Scroll maps, you must be on (v4.50.0 or later).
 2. Enable [Session Replay][1].
 3. Set`trackUserInteractions: true` in the SDK initialization to enable action tracking (required for Clickmaps).
 
 ## Getting started
 
 Navigate to [**Digital Experience > Real User Monitoring > Session Replay > Heatmaps**][2]. Select your application and view.
 
-On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. Under Map Type, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. Clicking one of these options takes you to the [heatmap page][2] for a particular view.
+On the [Real User Monitoring landing page][3], select your application from the [application selector][4] and view. To the left of the timeframe selector, you can select the type of heatmap you would like to view: Top Elements, Click Map, or Scroll Map. This takes you to the [heatmap page][2] for a particular view.
 
-{{< img src="real_user_monitoring/heatmaps/rum-heatmaps-getting-started.png" alt="Select an application to view heatmaps for it" style="width:100%;" >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-different-views.png" alt="The heatmaps page has multiple ways to show different views: by application, map type, device type, action name, and granular filters." style="width:100%;">}}
 
- You can switch the view being shown with the **View Name** and **Application** selectors at the top. To add more granular filters, like a specific geography for example, you can add a filter from the panel on the left side.
+You have the following additional view options:
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-filters-v2.png" alt="Shows the selector for selecting an application and a view from the options where you have already enabled session replay." style="width:100%;">}}
+- To switch the view being shown, use the **View Name** and **Application** selectors at the top.
+- To change the device view, use the **Device type** selector.
+- To filter by action name, use the **Filter actions by** dropdown.
+- To add more granular filters, like a specific geography for example, click the **Add Filter** button.
 
-## Click maps
+## Top Elements
 
-A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
+Top Elements aggregate click actions on a given view by displaying the most interacted-with elements and their rank. The ranking on the map itself corresponds to the action name on the side.
 
-{{< img src="real_user_monitoring/heatmaps/heatmap_v3.png" alt="Clickmap data overlayed on a website." style="width:100%;">}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-top-elements.png" alt="A ranking of the top elements clicked on a page." style="width:100%;">}}
 
-Each Click map also offers analytics such as:
+Hover over any action name in the panel to highlight the corresponding action on the map.
 
-- Where that page ranks out of all other visited pages
-- Unique user counts to that page
-- Any frustration signals on that page
+## Click maps
 
-Below the panel are all actions that occurred on the page, listed by frequency. When you click into an action, you can understand more about that interaction, for example:
+A Click map shows you the most interacted-with actions on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
path: content/en/real_user_monitoring/session_replay/heatmaps.md
user: login: iadjivon
body: ```suggestion
A Click map shows you the actions most interacted with on a given view by aggregating user click actions from sessions and visualizing them as blobs on the map.
```

Copied the section you edited in the Product analytics section
created_at: 2025-04-29T19:07:56Z
author_association: CONTRIBUTOR
diff_hunk: @@ -102,15 +111,15 @@ Heatmaps are based on RUM view names. Depending on how your RUM application is c
 
 ### The view that I selected is not showing the initial content.
 
-Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm smartly picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the [background](#backgrounds) of your heatmap, you can use the **Choose Background** button to navigate through the different states of the page and find the one you are looking for.
+Heatmaps are generated with Session Replay data. Datadog's intelligent algorithm picks a replay that is both recent and best matches the initial state of the page. In some cases, you might not be able to find the correct replay. To switch the snapshot of your heatmap, you can use the **Change Snapshot** button to navigate through the different states of a replay and find the one you are looking for. If the replay you're viewing does not have the snapshot you're looking for, you can use the **Choose Another Replay** button to select another replay of the same view.
 
-{{< img src="real_user_monitoring/heatmaps/heatmaps-background-selector.mp4" alt="Select a different background via the choose background button" video=true >}}
+{{< img src="real_user_monitoring/session_replay/heatmaps/heatmaps-change-the-snapshot.mp4" alt="Select a different background by clicking the Change Snapshot button" video=true >}}
 
 ### On the action list on the side of my heatmap, I see an icon showing an element that is not visibile in the heatmap.
path: content/en/real_user_monitoring/session_replay/heatmaps.md
user: login: iadjivon
body: ```suggestion
### On the action list on the side of my heatmap, I see an icon showing an element that is not visible in the heatmap.
```
created_at: 2025-04-29T19:11:16Z
author_association: CONTRIBUTOR
path: static/images/product_analytics/heatmaps/heatmaps-pa-features.png
user: login: iadjivon
body: Is this listed in the docs? 
(sorry if I missed it!)
created_at: 2025-04-29T19:14:58Z
author_association: CONTRIBUTOR

PR comments:
user: login: github-actions[bot]
created_at: 2025-04-24T19:58:54Z
body: ## Preview links (active after the `build_preview` check completes)




### Modified Files
* https://docs-staging.datadoghq.com/rtrieu/docs-10675-update-experience-change-heatmap-snapshot/product_analytics/heatmaps
* https://docs-staging.datadoghq.com/rtrieu/docs-10675-update-experience-change-heatmap-snapshot/real_user_monitoring/session_replay/heatmaps
author_association: CONTRIBUTOR
user: login: iadjivon
created_at: 2025-04-28T21:33:41Z
body: Hi Rosa, I assigned this to myself and created a jira card for an editorial review. Will work on this tomorrow, is that alright? Let me know the urgency on this and I'll be happy to reprioritize.
author_association: CONTRIBUTOR
user: login: rtrieu
created_at: 2025-04-29T19:32:10Z
body: /merge
author_association: CONTRIBUTOR
user: login: dd-devflow[bot]
created_at: 2025-04-29T19:32:14Z
body: <!-- "FeedbackWorkflowId":"963f21f0-0432-4bbb-b178-f05121cfa57e_36" -->
[View all feedbacks in Devflow UI.](https://mosaic.us1.ddbuild.io/devflow/logs/963f21f0-0432-4bbb-b178-f05121cfa57e_36)

`2025-04-29 19:32:13 UTC` :information_source: Start processing command `/merge`

---
`2025-04-29 19:32:22 UTC` :information_source: **MergeQueue:** waiting for PR to be ready

This merge request is not mergeable yet, because of pending checks/missing approvals. It will be added to the queue as soon as checks pass and/or get approvals.
**Note:** if you pushed new commits since the last approval, you may need additional approval.
You can remove it from the waiting list with `/remove` command.

---
`2025-04-29 19:58:51 UTC` :information_source: **MergeQueue:** This merge request was already merged

This pull request was merged directly.

author_association: NONE