diff --git a/docs/platforms/javascript/common/session-replay/index.mdx b/docs/platforms/javascript/common/session-replay/index.mdx
index 649bb1279153e4..5aeb8faa336d0e 100644
--- a/docs/platforms/javascript/common/session-replay/index.mdx
+++ b/docs/platforms/javascript/common/session-replay/index.mdx
@@ -24,6 +24,13 @@ notSupported:
 description: "Learn how to enable Session Replay in your app if it is not already set up."
 ---
 
+<PlatformSection supported={["javascript.capacitor"]}>
+  <Alert level="warning" title="Not Supported on Capacitor">
+
+Session Replay is no longer supported in `@sentry/capacitor` as of version 4.0.0. If you need Session Replay, we recommend [`@sentry/react-native`](/platforms/react-native/) or [`sentry-dart` (Flutter)](/platforms/flutter/).
+
+</Alert>
+</PlatformSection>
 <Include name="session-replay-web-report-bug.mdx" />
 
 [Session Replay](/product/explore/session-replay/) helps you get to the root cause of an error or latency issue faster by providing you with a video-like reproduction of what was happening in the user's browser before, during, and after the issue. You can rewind and replay your application's DOM state and see key user interactions, like mouse clicks, scrolls, network requests, and console entries, in a single combined UI inspired by your browser's DevTools.