From 90f958b57d13657dbde68e81cdf41b399d88d6e7 Mon Sep 17 00:00:00 2001
From: Billy Vong <billyvg@users.noreply.github.com>
Date: Mon, 16 Sep 2024 12:10:05 -0400
Subject: [PATCH] feat(replay): Add troubleshooting section for "Replay does
 not look correct"

Adds some common cases where a replay does not look correct

Closes https://github.com/getsentry/sentry-docs/issues/10886
---
 .../common/session-replay/troubleshooting.mdx | 23 +++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/docs/platforms/javascript/common/session-replay/troubleshooting.mdx b/docs/platforms/javascript/common/session-replay/troubleshooting.mdx
index 5c660e7cd67ca3..144416cd9b0b70 100644
--- a/docs/platforms/javascript/common/session-replay/troubleshooting.mdx
+++ b/docs/platforms/javascript/common/session-replay/troubleshooting.mdx
@@ -20,6 +20,21 @@ excerpt: ""
 description: "Troubleshooting Session Replay-specific Issues"
 ---
 
+<Expandable title="Replay does not look correct" permalink>
+
+There are a few category of cases where the replay playback does not match how your application looks. Below are some common causes and what next steps are if you experience this.
+
+### Missing elements from the replay
+
+* Usage of unsupported and/or deprecated elements such as `<frame>` (not to be confused with `<iframe>`)
+* Element is blocked by the [privacy configuration](/platforms/javascript/session-replay/privacy/#blocking) (by default, elements with the class name `sentry-block` or the attribute `data-sentry-block`)
+
+### CSS is wrong or missing
+
+* There may be edge cases with complex CSS selectors which break the styling. Please [file an issue on GitHub](https://github.com/getsentry/sentry-javascript/issues) if you enounter this.
+
+</Expandable>
+
 <Expandable title="My `canvas` elements aren't getting captured" permalink>
 
 Canvas is supported in SDK versions >= `7.98.0`. Please see the <PlatformLink to="/session-replay/#canvas-recording">canvas setup documention</PlatformLink> to get started with canvas recordings.
@@ -147,7 +162,7 @@ Using the [`captureConsoleIntegration`](https://docs.sentry.io/platforms/javascr
 
 <Expandable title="Clicks are incorrectly resulting in a dead or rage click" permalink>
 
-There are certain cases (such as clicking a button to play an audio clip) where Sentry incorrectly records a click as a dead click (note: rage clicks are a subset of dead clicks). As a workaround, you can use the [`slowClickIgnoreSelector`](/platforms/javascript/session-replay/configuration/#general-integration-configuration) configuration option to ignore dead clicks for specific selectors.
-
-If you want to turn off [rage click issues](/product/issues/issue-details/replay-issues/) altogether, you can disable them by going to the **Settings** page in Sentry, clicking "Projects", and selecting the project for which you want to disable rage clicks. From here, select "Replays" under the "PROCESSING" heading and toggle off "Create Rage Click Issues".
-</Expandable>
+---
+title: Troubleshooting
+sidebar_order: 9000
+notSupported: