Skip to content

Commit f26f785

Browse files
Update session-replay.mdx
After some testing, we should add expected behavior with iframe apps and session replay content.
1 parent b1335f0 commit f26f785

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

src/content/docs/browser/browser-monitoring/browser-pro-features/session-replay.mdx

+23
Original file line numberDiff line numberDiff line change
@@ -249,6 +249,29 @@ For more details on session replay, see the following sections:
249249
<link rel="stylesheet" href="assets.yoursite.com/styles.css" crossorigin="anonymous">
250250
```
251251
</Collapser>
252+
<Collapser
253+
id="Troubleshoot-iframe-content"
254+
title="Not seeing replays in your iframes"
255+
>
256+
### Problem
257+
258+
Session replay feature is enabled, but you're not seeing replay data for iframe content.
259+
260+
### Solution
261+
262+
Assuming a web page consists of a top level window with a child iframe, here are some possible fixes:
263+
* If the iframe is **same-origin**,
264+
* agent placed in the top level will capture session replay events in both the window and the iframe.
265+
* agent placed in the iframe will capture events only in its own context.
266+
* agents placed in both window and iframe will each report session replay events independently (with their own session) in line with the two bullets above.
267+
* If the iframe is **cross-origin**,
268+
* agent placed in the top level will only capture session replay events in the window; iframe will appear blank.
269+
* agent placed in the iframe will only capture events in the iframe.
270+
* if *recordCrossOriginIframes* is not enabled (current state of agent) in the replay options, agents placed in both window and iframe will each report session replay events independently (with their own session) in line with the two bullets above.
271+
* if *recordCrossOriginIframes* <u>is</u> enabled and agents are in both window and iframe, the iframe agent does <u>not</u> report session replay events. However, the window agent will report events with the cross-origin iframe events captured in replay.
272+
* Please note, session replay is not compatible with <frame> elements and this is unsupported.
273+
274+
</Collapser>
252275
</CollapserGroup>
253276

254277
## Manually record session replays [#manual-replays]

0 commit comments

Comments
 (0)