Skip to content

Update iOS Session Replay Docs for GA #1952

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Conversation

jaredmixpanel
Copy link
Contributor

This pull request updates the iOS Session Replay documentation to reflect changes in the SDK's API, improve clarity, and provide additional guidance for developers. Key updates include the removal of outdated beta program disclaimers, adjustments to configuration options, and the addition of new features such as manual screenshot capture and identity management.

Updates to SDK API and Configuration

  • Replaced recordSessionsPercent with autoStartRecordingSessionsPercent in MPSessionReplayConfig to reflect changes in sampling behavior. Recording now starts automatically if the sampling check passes. [1] [2]
  • Added new configuration options: autoStartRecording, flushInterval, and enableLogging. Updated default values for autoMaskedViews to include .map.
  • Updated logging configuration to use enableLogging in MPSessionReplayConfig instead of setting loggingEnabled on the instance.

Enhancements to Documentation Clarity

  • Removed outdated disclaimers about the beta program and potential bugs.
  • Improved phrasing and terminology, such as changing "capturing replay data" to "recording replay data" and clarifying that autoStartRecording is enabled by default. [1] [2]

New Features and Examples

  • Added support for manual screenshot capture with .captureScreenshot() and .captureScreenshot(withTouchEvent:).
  • Introduced identity management with .identify(distinctId:) to update the user ID dynamically.
  • Provided examples for manual flushing of session replay events using .flush().

Privacy and Masking Updates

  • Clarified that UITextField inputs are always masked and cannot be unmasked, while other elements like UILabel and MKMapView can be unmasked using autoMaskedViews.
  • Updated descriptions of mpReplaySensitive to emphasize its use for marking views as "sensitive" or "safe."

@jaredmixpanel jaredmixpanel requested a review from a team as a code owner July 16, 2025 23:45
@jaredmixpanel jaredmixpanel requested review from ishamehramixpanel and removed request for a team July 16, 2025 23:45
Copy link

vercel bot commented Jul 16, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 17, 2025 0:17am

@jaredmixpanel jaredmixpanel requested a review from Copilot July 16, 2025 23:46
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request updates the iOS Session Replay documentation to reflect the SDK's General Availability (GA) release, removing beta program disclaimers and updating API references to match the latest SDK version. The documentation has been significantly restructured to improve clarity and provide comprehensive guidance for developers implementing session replay functionality.

  • Removed all beta program warnings and disclaimers since the feature is now generally available
  • Updated SDK API references including configuration parameter names and initialization patterns
  • Added new functionality documentation for manual screenshot capture, identity management, and manual flushing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants