diff --git a/docs/platforms/apple/guides/ios/session-replay/troubleshooting.mdx b/docs/platforms/apple/guides/ios/session-replay/troubleshooting.mdx
index 488d097a5a25e..25b529bbf02f6 100644
--- a/docs/platforms/apple/guides/ios/session-replay/troubleshooting.mdx
+++ b/docs/platforms/apple/guides/ios/session-replay/troubleshooting.mdx
@@ -5,6 +5,22 @@ notSupported:
 description: "Troubleshoot and resolve common issues with the iOS Session Replay."
 ---
 
+<Expandable title="AVFoundation views and layers are not rendered" permalink>
+
+Session Replay currently cannot capture content from AVFoundation views and layers. This includes:
+
+- `AVPlayerLayer` and other AVFoundation-backed video content
+- `AVCaptureVideoPreviewLayer` used for camera previews
+- Any media content rendered using AVFoundation components
+
+As a result, camera views, video players, and other AVFoundation-based UI elements will not appear in session replays, even when using `unmaskedViewClasses` configuration.
+
+We are aware of this limitation and are exploring potential solutions to support AVFoundation content in future releases.
+
+You can follow the progress in [this GitHub issue](https://github.com/getsentry/sentry-cocoa/issues/5835).
+
+</Expandable>
+
 <Expandable title="Session Replay is not recording with custom window setup" permalink>
 
 If you have a custom window setup (e.g., multiple instances of `UIWindow`), you need to ensure that the Sentry SDK is able to find the correct window.
@@ -70,4 +86,4 @@ final class SceneDelegate: NSObject, UIWindowSceneDelegate {
 }
 ```
 
-</Expandable>
\ No newline at end of file
+</Expandable>