Changelog
Release notes of the Screeb iOS SDK, newest first.
Get every release in your feed reader: subscribe with RSS.
v4.3.0 β 2026-09-28
Section titled βv4.3.0 β 2026-09-28βπ New features
Section titled βπ New featuresβ- Added
Screeb.setAnonymousId(anonymousId:)to link the current respondent to the anonymous id your CDP already uses (e.g. Amplitude device id, Segment or RudderStack anonymous id). The respondent stays anonymous, and if that id already belongs to an existing respondent, Screeb switches to it (unless the current one is already identified). Call it right afterinitSdk.
π Bug fixes
Section titled βπ Bug fixesβ- SDK error reports are no longer sent over the network before
initSdkruns, since the host app may not have collected consent yet, they now stay local until then. Error messages also no longer include command arguments or other data that could carry visitor identities or properties.
v4.2.1 β 2026-09-25
Section titled βv4.2.1 β 2026-09-25βπ Bug fixes
Section titled βπ Bug fixesβ- Screenshot answers no longer capture the iOS screen-sharing βStop Sharingβ overlay β the SDK now waits for that system sheet to be dismissed before grabbing the frame.
- Session replay recovers on its own if an update is ever lost in transit: a changing screen now gets a fresh keyframe at least every 30 seconds instead of staying wrong for the rest of the session.
- Session replay no longer misses the last change made right as a screen settles.
- A brief memory warning no longer keeps session replay (quality, resolution, capture rate) throttled for the rest of the time the app is in the foreground β the throttling now eases back automatically a few seconds after the warning stops recurring.
β‘ Improvements
Section titled ββ‘ Improvementsβ- Session replay capture does less work for hidden looping animations, duplicate change regions, and paused capture passes, lowering CPU and battery impact with no change in replay fidelity.
v4.2.0 β 2026-08-24
Section titled βv4.2.0 β 2026-08-24βπ New features
Section titled βπ 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
Section titled βπ 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
Section titled βv4.1.0 β 2026-08-20βπ New features
Section titled βπ 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
Section titled βπ 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/1values were sometimes sent as booleans and silently dropped by number-typed properties. - Fixed
closeSdkoccasionally 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
Section titled ββ‘ 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
Section titled βv4.0.4 β 2026-08-13βπ Bug fixes
Section titled βπ 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
Section titled ββ‘ 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
Section titled βv4.0.3 β 2026-08-07βπ Bug fixes
Section titled βπ 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
Section titled ββ‘ 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
Section titled βv4.0.2 β 2026-07-08βπ Improvements
Section titled βπ 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
Section titled βv3.1.1 β 2026-02-10βπ Improvements
Section titled βπ Improvementsβ- Added
sessionReplay{start|stop}commands.
v3.1.0 β 2026-02-09
Section titled βv3.1.0 β 2026-02-09βπ Improvements
Section titled βπ Improvementsβ- Added
getIdentitycommand. - Added Callback result to debug and debugTargeting commands.
v3.0.3 β 2026-02-06
Section titled βv3.0.3 β 2026-02-06βπ Improvements
Section titled βπ Improvementsβ- Added file picker for In-App messages video.
v3.0.2 β 2026-01-13
Section titled βv3.0.2 β 2026-01-13βπ Improvements
Section titled βπ Improvementsβ- Hotfixes.
v3.0.1 β 2026-01-12
Section titled βv3.0.1 β 2026-01-12βπ Improvements
Section titled βπ Improvementsβ- Ensure webview is not in the accessible tree when it is hidden.
v3.0.0 β 2026-01-12
Section titled βv3.0.0 β 2026-01-12βπ Improvements
Section titled βπ 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
Section titled βv2.2.4 β 2025-12-04βπ Improvements
Section titled βπ Improvementsβ- Fixed SDK methods Objective-C type.
v2.2.2 β 2025-11-18
Section titled βv2.2.2 β 2025-11-18βπ Improvements
Section titled βπ 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
Section titled βv2.2.1 β 2025-10-23βπ Improvements
Section titled βπ Improvementsβ- Thread safety fixes.
v2.2.0 β 2025-10-23
Section titled βv2.2.0 β 2025-10-23βπ Improvements
Section titled βπ Improvementsβ- Added startMessage, closeMessage commands.
- Added optional surveyId param to closeSurvey.
v2.1.14 β 2025-10-16
Section titled βv2.1.14 β 2025-10-16βπ Improvements
Section titled βπ Improvementsβ- Support In-App Messages.
- Removed deprecated βautomaticScreenDetectionβ InitOptions.
- Bump min iOS version to 12.0.
v2.1.13 β 2025-06-18
Section titled βv2.1.13 β 2025-06-18βπ Improvements
Section titled βπ Improvementsβ- Ensure sequential messages consume.
v2.1.12 β 2025-06-04
Section titled βv2.1.12 β 2025-06-04βπ Improvements
Section titled βπ 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
Section titled βv2.1.11 β 2025-02-03βπ Improvements
Section titled βπ Improvementsβ- Thread safety fixes.
v2.1.10 β 2025-01-31
Section titled βv2.1.10 β 2025-01-31βπ Improvements
Section titled βπ Improvementsβ- Ensure commands execution orders.
v2.1.9 β 2024-12-19
Section titled βv2.1.9 β 2024-12-19βπ Improvements
Section titled βπ Improvementsβ- Reduce memory usage caused by logging.
v2.1.8 β 2024-12-09
Section titled βv2.1.8 β 2024-12-09βπ Improvements
Section titled βπ Improvementsβ- Fixed case where content is untouchable.
v2.1.7 β 2024-10-02
Section titled βv2.1.7 β 2024-10-02βπ Improvements
Section titled βπ Improvementsβ- Add language parameter
v2.1.6 β 2024-07-30
Section titled βv2.1.6 β 2024-07-30βπ Improvements
Section titled βπ Improvementsβ- Fixed double encoding.
v2.1.5 β 2024-07-30
Section titled βv2.1.5 β 2024-07-30βπ Improvements
Section titled βπ Improvementsβ- Prepare support of new hooks in secondary SDK.
v2.1.4 β 2024-07-29
Section titled βv2.1.4 β 2024-07-29βπ Improvements
Section titled βπ Improvementsβ- Fixed hook result encoding.
v2.1.3 β 2024-07-29
Section titled βv2.1.3 β 2024-07-29βπ Improvements
Section titled βπ Improvementsβ- Support new
onSurveyDisplayAllowedandonMessageDisplayAllowedhooks.
v2.1.2 β 2024-07-22
Section titled βv2.1.2 β 2024-07-22βπ Improvements
Section titled βπ Improvementsβ- Fixed destroy animation.
- Improved key window handling.
v2.1.1 β 2024-06-12
Section titled βv2.1.1 β 2024-06-12βπ Improvements
Section titled βπ Improvementsβ- Fixed error and message printing.
- Improved key window handling.
v2.1.0 β 2024-05-28
Section titled βv2.1.0 β 2024-05-28βπ Improvements
Section titled βπ Improvementsβ- Improved surveys hit boxes.
- Prepare support for in-app messages.
- Prepare support for session recording.
v2.0.13 β 2024-04-11
Section titled βv2.0.13 β 2024-04-11βπ Improvements
Section titled βπ Improvementsβ- Fixed possible non-interactive surveys
v2.0.12 β 2024-04-10
Section titled βv2.0.12 β 2024-04-10βπ Improvements
Section titled βπ Improvementsβ- Allow lazy init SDK without any context
- Better handling of window switching #2
- Fixed threads warnings
v2.0.11 β 2024-04-05
Section titled βv2.0.11 β 2024-04-05βπ Improvements
Section titled βπ Improvementsβ- Multi-platform support
- Better handling of window switching
v2.0.10 β 2024-02-05
Section titled βv2.0.10 β 2024-02-05βπ Improvements
Section titled βπ Improvementsβ- Improved commands encoding.
- Handle a rare case where a survey is not properly closed.
v2.0.9 β 2024-01-09
Section titled βv2.0.9 β 2024-01-09βπ Improvements
Section titled βπ Improvementsβ- Improved context tracking.
v2.0.8 β 2024-01-03
Section titled βv2.0.8 β 2024-01-03βπ Improvements
Section titled βπ Improvementsβ- Fixed Close/Init SDK lifecycle.
v2.0.7 β 2023-12-11
Section titled βv2.0.7 β 2023-12-11βπ Improvements
Section titled βπ Improvementsβ- Properly handle SSL errors.
v2.0.4β2.0.6 β 2023-12-11
Section titled βv2.0.4β2.0.6 β 2023-12-11βπ Improvements
Section titled βπ Improvementsβ- Improve errors reporting.
- Warn about debug mode enabled.
v2.0.3 β 2023-09-08
Section titled βv2.0.3 β 2023-09-08βπ Improvements
Section titled βπ 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
Section titled βv2.0.1β2.0.2 β 2023-09-08βπ Improvements
Section titled βπ Improvementsβ- Added closeSurvey command.
- Fixed surveys not showing in some cases.
- Fixed surveys on screen rotation.
v2.0.0 β 2023-08-02
Section titled βv2.0.0 β 2023-08-02βπ Improvements
Section titled βπ 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
Section titled βv1.13.2 β 2023-06-07βπ Improvements
Section titled βπ Improvementsβ- New βRange ratingβ type of questions
v1.13.1 β 2023-05-17
Section titled βv1.13.1 β 2023-05-17βπ Improvements
Section titled βπ Improvementsβ- Fixed Version Targeting
v1.13.0 β 2023-04-28
Section titled βv1.13.0 β 2023-04-28βπ Improvements
Section titled βπ ImprovementsβstartSurveycommand now accepts theignoreSurveyStatusargument (default: true)- Better log management
- Fixed multiple βEnd surveyβ buttons
v1.12.4 β 2023-04-21
Section titled βv1.12.4 β 2023-04-21βπ Improvements
Section titled βπ 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
Section titled βv1.12.2β1.12.3 β 2023-03-10βπ Improvements
Section titled βπ Improvementsβ- Fixed Validation event and group name
- Fixed Disable Automatic screen detection
v1.12.1 β 2023-02-24
Section titled βv1.12.1 β 2023-02-24βπ Improvements
Section titled βπ 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
Section titled βv1.12.0 β 2023-02-09βπ Improvements
Section titled βπ Improvementsβ- Added debug and debugTargeting commands
- Added resetIdentity command
- Added closeSdk command
- Fixed survey closing on reduced mod
v1.11.0 β 2023-01-25
Section titled βv1.11.0 β 2023-01-25βπ Improvements
Section titled βπ Improvementsβ- Response expiration
v1.10.5 β 2023-01-24
Section titled βv1.10.5 β 2023-01-24βπ Improvements
Section titled βπ Improvementsβ- Fixed validation issues in visitor properties
v1.10.4 β 2022-10-29
Section titled βv1.10.4 β 2022-10-29βπ Improvements
Section titled βπ Improvementsβ- Make targeting more reliable in order to not trigger survey in a corner-case
v1.10.3 β 2022-10-18
Section titled βv1.10.3 β 2022-10-18βπ Improvements
Section titled βπ Improvementsβ- Replace numeric emojis by custom SVG
- Fixed Survey superposition on the app