Skip to main content
Version: iOS SDK

Changelog

v4.2.0 — 2026-08-24​

🚀 New features​

  • Exit-intent surveys now work on native iOS: leaving a tracked screen can trigger a survey, as on web. Requires screen tracking (trackScreen) instrumentation.
  • New "inactivity" targeting rule: trigger a survey after the respondent has stopped interacting with the app for a configured time.

🐛 Bug fixes​

  • Time-based triggers (delay, session duration, inactivity) now fire on time: the SDK arms its own native timer instead of relying on webview timers, which iOS throttles while the webview is hidden.

v4.1.0 — 2026-08-20​

🚀 New features​

  • Heatmaps now work for native iOS sessions — clicks, dead clicks, rage clicks and device type are captured the same way as on web.
  • Session replay anonymization (session_replay_anonymize) is now enforced on-device: when enabled, text and sensitive images are masked in the recording, not just on web.

🐛 Bug fixes​

  • Fixed the survey becoming unreachable (stuck behind the app, unresponsive to touches) after a respondent opened the photo/file picker from a modally-presented screen — a very common integration pattern.
  • Fixed visitor properties bridged from Flutter/React Native: numeric 0/1 values were sometimes sent as booleans and silently dropped by number-typed properties.
  • Fixed closeSdk occasionally failing silently when called right as a survey-close screen reloads.
  • Fixed masked/redacted content sometimes leaking into captured pixels (screenshots, cropped or scrolled captures).
  • Fixed replay recordings sometimes opening on a blank screen instead of the real starting content.
  • Fixed several rare crashes in session replay (low memory, backgrounding, network changes, rapid start/stop).
  • Fixed heatmap clicks occasionally being attributed to the previous screen right after navigation.

⚡ Improvements​

  • Session replay's impact on the host app's main thread is substantially reduced, keeping the app smoother while recording, especially on busy or animated screens.
  • The SDK release artifact is now signed with Screeb's vendor identity, so Xcode can verify the SDK's authenticity and warn if it ever changes.
  • The attach-file editor title is now generic ("Edit") for any picked image, and its toolbar respects the device's safe area.

v4.0.4 — 2026-08-13​

🐛 Bug fixes​

  • Respondents can attach a picture again: tapping the attach button in a survey now opens the system photo menu, where it previously did nothing at all.
  • The photo library no longer opens behind the survey, where its photos could be seen but not tapped.

⚡ Improvements​

  • The attach menu is the iOS one: photo library, camera and files, in the language of the device, filtered to the picture formats a survey accepts.

v4.0.3 — 2026-08-07​

🐛 Bug fixes​

  • Fixed a rare crash that could close the app while session replay was recording.
  • Fixed a crash when the app was opened from a malformed Screeb link.
  • Fixed a crash that could happen on the first network error after startup.
  • Screeb no longer closes the app when memory runs low while recording: it skips a frame instead.
  • Fixed the order of screen and event tracking, so events are always attached to the screen they happened on.
  • Fixed occasional instability when Screeb methods are called from a background thread.

⚡ Improvements​

  • Session replay stays light for the whole session on apps where it could previously fall back to full-screen captures.
  • Command callbacks and survey hooks are called back on a background thread again, as they were before 4.0.2.

v4.0.2 — 2026-07-08​

🚀 Improvements​

  • More robust session replay, even under heavy memory pressure.
  • Lower CPU and memory usage while recording.
  • In-app surveys and messages stay reliably in the foreground.

v3.1.1 — 2026-02-10​

🚀 Improvements​

  • Added sessionReplay{start|stop} commands.

v3.1.0 — 2026-02-09​

🚀 Improvements​

  • Added getIdentity command.
  • Added Callback result to debug and debugTargeting commands.

v3.0.3 — 2026-02-06​

🚀 Improvements​

  • Added file picker for In-App messages video.

v3.0.2 — 2026-01-13​

🚀 Improvements​

  • Hotfixes.

v3.0.1 — 2026-01-12​

🚀 Improvements​

  • Ensure webview is not in the accessible tree when it is hidden.

v3.0.0 — 2026-01-12​

🚀 Improvements​

  • Session Replay in Beta.
  • Added disableMirror to InitOptions to force disable In-App messages mirroring and Session Replay.

v2.2.4 — 2025-12-04​

🚀 Improvements​

  • Fixed SDK methods Objective-C type.

v2.2.2 — 2025-11-18​

🚀 Improvements​

  • AnyEncodable is now unneeded and should be removed.
  • SDK methods are now Objective-C compatible.
  • Fixed Closing In-App messages builder reopening it.

v2.2.1 — 2025-10-23​

🚀 Improvements​

  • Thread safety fixes.

v2.2.0 — 2025-10-23​

🚀 Improvements​

  • Added startMessage, closeMessage commands.
  • Added optional surveyId param to closeSurvey.

v2.1.14 — 2025-10-16​

🚀 Improvements​

  • Support In-App Messages.
  • Removed deprecated "automaticScreenDetection" InitOptions.
  • Bump min iOS version to 12.0.

v2.1.13 — 2025-06-18​

🚀 Improvements​

  • Ensure sequential messages consume.

v2.1.12 — 2025-06-04​

🚀 Improvements​

  • Auto-recover on network change.
  • Fixed hitboxes on keyboard visibility changes.
  • Threads improvements.
  • Added "distributionId" param to startSurvey.

v2.1.11 — 2025-02-03​

🚀 Improvements​

  • Thread safety fixes.

v2.1.10 — 2025-01-31​

🚀 Improvements​

  • Ensure commands execution orders.

v2.1.9 — 2024-12-19​

🚀 Improvements​

  • Reduce memory usage caused by logging.

v2.1.8 — 2024-12-09​

🚀 Improvements​

  • Fixed case where content is untouchable.

v2.1.7 — 2024-10-02​

🚀 Improvements​

  • Add language parameter

v2.1.6 — 2024-07-30​

🚀 Improvements​

  • Fixed double encoding.

v2.1.5 — 2024-07-30​

🚀 Improvements​

  • Prepare support of new hooks in secondary SDK.

v2.1.4 — 2024-07-29​

🚀 Improvements​

  • Fixed hook result encoding.

v2.1.3 — 2024-07-29​

🚀 Improvements​

  • Support new onSurveyDisplayAllowed and onMessageDisplayAllowed hooks.

v2.1.2 — 2024-07-22​

🚀 Improvements​

  • Fixed destroy animation.
  • Improved key window handling.

v2.1.1 — 2024-06-12​

🚀 Improvements​

  • Fixed error and message printing.
  • Improved key window handling.

v2.1.0 — 2024-05-28​

🚀 Improvements​

  • Improved surveys hit boxes.
  • Prepare support for in-app messages.
  • Prepare support for session recording.

v2.0.13 — 2024-04-11​

🚀 Improvements​

  • Fixed possible non-interactive surveys

v2.0.12 — 2024-04-10​

🚀 Improvements​

  • Allow lazy init SDK without any context
  • Better handling of window switching #2
  • Fixed threads warnings

v2.0.11 — 2024-04-05​

🚀 Improvements​

  • Multi-platform support
  • Better handling of window switching

v2.0.10 — 2024-02-05​

🚀 Improvements​

  • Improved commands encoding.
  • Handle a rare case where a survey is not properly closed.

v2.0.9 — 2024-01-09​

🚀 Improvements​

  • Improved context tracking.

v2.0.8 — 2024-01-03​

🚀 Improvements​

  • Fixed Close/Init SDK lifecycle.

v2.0.7 — 2023-12-11​

🚀 Improvements​

  • Properly handle SSL errors.

v2.0.4→2.0.6 — 2023-12-11​

🚀 Improvements​

  • Improve errors reporting.
  • Warn about debug mode enabled.

v2.0.3 — 2023-09-08​

🚀 Improvements​

  • Allow to init SDK without context that'll default to the app one.
  • Remove false translatesAutoresizingMaskIntoConstraints.

v2.0.1→2.0.2 — 2023-09-08​

🚀 Improvements​

  • Added closeSurvey command.
  • Fixed surveys not showing in some cases.
  • Fixed surveys on screen rotation.

v2.0.0 — 2023-08-02​

🚀 Improvements​

  • The SDK has been rewritten from scratch to provide greater stability, instant updates of Screeb features, and be even lighter.
  • All SDK dependencies have been removed, and the minimum iOS version has been reduced from 12.4 to 11.0.

Improvements (PS: Same as rc.1, rc.2, and rc.3 but with a new feature called hooks) 🚀

  • The SDK has been rewritten from scratch to provide greater stability, instant updates of Screeb features, and be even lighter.
  • All SDK dependencies have been removed, and the minimum iOS version has been reduced from 12.4 to 11.0.

v1.13.2 — 2023-06-07​

🚀 Improvements​

  • New "Range rating" type of questions

v1.13.1 — 2023-05-17​

🚀 Improvements​

  • Fixed Version Targeting

v1.13.0 — 2023-04-28​

🚀 Improvements​

  • startSurvey command now accepts the ignoreSurveyStatus argument (default: true)
  • Better log management
  • Fixed multiple "End survey" buttons

v1.12.4 — 2023-04-21​

🚀 Improvements​

  • Added Swift Package Manager support
  • Fixed a bug on buttons having no emoji.
  • Retry request on network failure

v1.12.2→1.12.3 — 2023-03-10​

🚀 Improvements​

  • Fixed Validation event and group name
  • Fixed Disable Automatic screen detection

v1.12.1 — 2023-02-24​

🚀 Improvements​

  • Build SDK with Xcode 13.2.1 and Swift 5.5.2 (1300.0.47.5) to fix compilation issue and support swift version 5.5.2+

v1.12.0 — 2023-02-09​

🚀 Improvements​

  • Added debug and debugTargeting commands
  • Added resetIdentity command
  • Added closeSdk command
  • Fixed survey closing on reduced mod

v1.11.0 — 2023-01-25​

🚀 Improvements​

  • Response expiration

v1.10.5 — 2023-01-24​

🚀 Improvements​

  • Fixed validation issues in visitor properties

v1.10.4 — 2022-10-29​

🚀 Improvements​

  • Make targeting more reliable in order to not trigger survey in a corner-case

v1.10.3 — 2022-10-18​

🚀 Improvements​

  • Replace numeric emojis by custom SVG
  • Fixed Survey superposition on the app