⚠️ iOS 26 Compatibility Notice
Session Replay is now disabled by default for apps built with Xcode 26+ running on iOS 26+ due to Apple's "Liquid Glass" rendering changes affecting SwiftUI automasking. UIKit and manual masking are unaffected. This is an industry-wide issue impacting all session replay vendors.
If you need Session Replay on iOS 26+, you can force-enable it:
let config = MPSessionReplayConfig(
autoMaskedViews: [], // Disable automasking
wifiOnly: false
)
config.enableSessionReplayOniOS26AndLater = true
MPSessionReplay.initialize(
token: Mixpanel.mainInstance().apiToken,
distinctId: Mixpanel.mainInstance().distinctId,
config: config
)It's safe to enable if any of the following apply:
- Your app is built with Xcode 16 or earlier
- Your app does not use SwiftUI
- You're not using automasking (i.e., you already manually mask sensitive views)
If you rely on automasking in a SwiftUI app and your app is built with Xcode 26+:
- Disable automasking and manually mark sensitive views using
.mpReplaySensitive(true) - Test thoroughly and review captured replays to confirm masking works as expected
We are actively investigating fixes for this issue.
What's Changed
- Update to v1.2.0 by @jaredmixpanel in #17
Full Changelog: v1.1.6...v1.2.0