feat(apple): Add warning for session replay disabled with iOS 26.0 Liquid Glass (#15201)

## DESCRIBE YOUR PR

Adds a warning to the Apple docs for Session Replay explaining why
session replay is disabled starting with [Cocoa SDK
8.57.0](https://github.com/getsentry/sentry-cocoa/releases/tag/8.57.0)

## IS YOUR CHANGE URGENT?  

Help us prioritize incoming PRs by letting us know when the change needs
to go live.
- [x] Urgent deadline (GA date, etc.): asap - important warning/info
- [ ] Other deadline: <!-- ENTER DATE HERE -->
- [ ] None: Not urgent, can wait up to 1 week+

## SLA

- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
added an urgent due date to it.
Thanks in advance for your help!

## PRE-MERGE CHECKLIST

*Make sure you've checked the following before merging your changes:*

- [x] Checked Vercel preview for correctness, including links
- [x] PR was reviewed and approved by any necessary SMEs (subject matter
experts)
- [x] PR was reviewed and approved by a member of the [Sentry docs
team](https://github.com/orgs/getsentry/teams/docs)

## LEGAL BOILERPLATE

<!-- Sentry employees and contractors can delete or ignore this section.
-->

Look, I get it. The entity doing business as "Sentry" was incorporated
in the State of Delaware in 2015 as Functional Software, Inc. and is
gonna need some rights from me in order to utilize my contributions in
this here PR. So here's the deal: I retain all rights, title and
interest in and to my contributions, and by keeping this boilerplate
intact I confirm that Sentry can use, modify, copy, and redistribute my
contributions, under Sentry's choice of terms.

## EXTRA RESOURCES

- [Sentry Docs contributor guide](https://docs.sentry.io/contributing/)

---------

Co-authored-by: Philipp Hofmann <[email protected]>

Author: philprime

docs/platforms/apple/common/session-replay/customredact.mdx

@@ -16,7 +16,7 @@ notSupported:
 </PlatformSection>
 
 <PlatformSection notSupported={["apple", "apple.macos", "apple.tvos", "apple.watchos", "apple.visionos"]}>
-<Alert>
+<Alert level="warning">
 
 Before enabling Session Replay in production, verify your masking configuration to ensure no sensitive data is captured. Our default settings aggressively mask potentially sensitive data, but if you modify these settings or update UI frameworks or system SDKs, you must thoroughly test your application. If you find any masking issues or sensitive data that should be masked but isn't, please [create a GitHub issue](https://github.com/getsentry/sentry-cocoa/issues/new/choose) and avoid deploying to production with Session Replay enabled until the issue is resolved.
 
@@ -124,4 +124,4 @@ struct ContentView_Previews: PreviewProvider {
 }
 ```
 
-</PlatformSection>
+</PlatformSection>

docs/platforms/apple/common/session-replay/index.mdx

@@ -14,12 +14,36 @@ notSupported:
 
 <PlatformSection notSupported={["apple", "apple.macos", "apple.tvos", "apple.watchos", "apple.visionos"]}>
 
-<Alert level="warning">
+<Alert level="warning" title="All iOS developers">
 
 Before enabling Session Replay in production, verify your masking configuration to ensure no sensitive data is captured. Our default settings aggressively mask potentially sensitive data, but if you modify these settings or update UI frameworks or system SDKs, you must thoroughly test your application. If you find any masking issues or sensitive data that should be masked but isn't, please [create a GitHub issue](https://github.com/getsentry/sentry-cocoa/issues/new/choose) and avoid deploying to production with Session Replay enabled until the issue is resolved.
 
 </Alert>
 
+<Alert level="warning" title="iOS 26.0+ - Liquid Glass">
+
+<strong>Session Replay is disabled by default on iOS 26.0+ with Xcode 26.0+ to prevent potential PII leaks</strong>
+
+Due to potential masking issues introduced by Apple's Liquid Glass rendering changes in iOS 26.0, Session Replay is now <strong>automatically disabled</strong> on apps running iOS 26.0+ when built with Xcode 26.0 or later starting with Sentry Cocoa <strong>8.57.0</strong>. This is a defensive measure to protect user privacy and prevent potential PII leaks until masking is reliably supported. Earlier SDK versions do not include this safeguard and may be affected by unreliable masking on iOS 26.0 when built with Xcode 26.0 (Liquid Glass). We recommend upgrading to 8.57.0+ or, if you can't upgrade the SDK, disabling Session Replay manually.
+
+Session Replay will work normally if:
+
+- Your app runs on iOS versions prior to 26.0, OR
+- Your app is built with Xcode prior to 26.0, OR
+- Your app explicitly sets <code>UIDesignRequiresCompatibility</code> to <code>YES</code> in <code>Info.plist</code>
+
+<strong>Override (use with caution):</strong> If you understand the PII risks and want to enable session replay anyway, you can set:
+
+```swift
+options.experimental.enableSessionReplayInUnreliableEnvironment = true
+```
+
+This experimental override option will be removed in a future minor version once the masking issues are resolved.
+
+Follow the progress on fixing masking for iOS 26.0 (Liquid Glass) in <a href="https://github.com/getsentry/sentry-cocoa/issues/6390">GitHub issue #6390</a>.
+
+</Alert>
+
 [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 reproduction of what was happening in the user's device before, during, and after the issue. You can rewind and replay your application's state and see key user interactions, like taps, swipes, network requests, and console entries, in a single UI.
 
 By default, our Session Replay SDK masks all text content, images, and user input, giving you heightened confidence that no sensitive data will leave the device. To learn more, see [product docs](/product/explore/session-replay/).

docs/platforms/apple/common/session-replay/troubleshooting.mdx

@@ -17,6 +17,28 @@ notSupported:
 
 <PlatformSection notSupported={["apple", "apple.macos", "apple.tvos", "apple.watchos", "apple.visionos"]}>
 
+<Expandable title="Why is Session Replay not running on iOS 26.0?" permalink>
+
+Due to potential masking issues introduced by Apple's Liquid Glass rendering changes in iOS 26.0, Session Replay is now <strong>automatically disabled</strong> on apps running iOS 26.0+ when built with Xcode 26.0 or later starting with Sentry Cocoa <strong>8.57.0</strong>. This is a defensive measure to protect user privacy and prevent potential PII leaks until masking is reliably supported. Earlier SDK versions do not include this safeguard and may be affected by unreliable masking on iOS 26.0 when built with Xcode 26.0 (Liquid Glass). We recommend upgrading to 8.57.0+ or, if you can't upgrade the SDK, disabling Session Replay manually.
+
+Session Replay will work normally if:
+
+- Your app runs on iOS versions prior to 26.0, OR
+- Your app is built with Xcode prior to 26.0, OR
+- Your app explicitly sets <code>UIDesignRequiresCompatibility</code> to <code>YES</code> in <code>Info.plist</code>
+
+If you understand the PII risks and want to enable Session Replay anyway, you can override this behavior:
+
+```swift
+options.experimental.enableSessionReplayInUnreliableEnvironment = true
+```
+
+This experimental override option will be removed in a future minor version once the masking issues are resolved.
+
+You can follow the ongoing work to fix masking for iOS 26.0 (Liquid Glass) in <a href="https://github.com/getsentry/sentry-cocoa/issues/6390">GitHub issue #6390</a>.
+
+</Expandable>
+
 <Expandable title="Does Session Replay work with UIKit, SwiftUI or AppKit?" permalink>
 
 Session Replay works with both UIKit and SwiftUI.