Guides and Surveys Mobile SDK Changelog | Amplitude Guides and Surveys

3.1.0 (Android, iOS, React Native) [2026-02-13]

✨ Features

Feat: on boot, allow "user ID" to be null or blank as long as device ID is specified (GSDK-732) [android, ios, rn]

🐛 Fixes

Fix: fix auto-advance logic (GSDK-859) [android, ios]
Fix: race condition causing pin nudge to be unable to render until the view hierarchy is updated (GSDK-827, GSDK-844) [ios]

3.0.0 (Android, iOS, React Native) [2026-02-11]

🚨 Breaking Changes (iOS only)

AmplitudeEngagement is now an interface rather than a class. New instances (as of 3.0.0) are created using AmplitudeEngagementFactory.make rather than the AmplitudeEngagement constructor (GSDK-690) [ios]

✨ Features

Feat: add SDK methods disable which temporarily hides any displayed guides or surveys and enable which shows them again (GSDK-513) [android,ios,rn]
Feat: add SDK method shutdown to React Native SDK binding (GSDK-769) [rn]
Feat: add Minimum SDK version support to App Management so older SDK versions don't initialize Guides and Surveys [android,ios,rn]

🐛 Fixes

Fix: fix theming issues (GSDK-845, GSDK-847) [android, ios]
Fix: fix tap outside to close behavior for modals (GSDK-850) [android]

2.1.1 (Android, iOS, React Native) [2026-02-02]

🐛 Fixes

Fix: trailing comma issue causing build error on Swift compiler less than version 6.1 [rn]
Fix: fix keyboard layout bug during iOS 26 device rotation (GSDK-632) [ios]
Fix: restore nudge keyboard after configuration change (GSDK-831) [android]

2.1.0 (Android, iOS, React Native) [2026-02-02]

✨ Features

Feat: add support for autoRefreshIntervalSeconds option to AmplitudeBootOptions to configure the auto-refresh interval for the SDK (GSDK-799) [android, ios]
Feat: add SDK method setAutoRefreshInterval to configure the auto-refresh interval for the SDK on the fly (GSDK-799) [android, ios]
Feat: add SDK method refresh to manually trigger a refresh of targeting data (GSDK-799) [android, ios]

🐛 Fixes

Fix: fix theming issues (GSDK-676) [android, ios]
Fix: ensure Pin guide is displayed when it follows another guide in a Tour (a multi-step guide) (GSDK-827) [ios]
Fix: reposition nudge when keyboard shows (GSDK-782) [android]
Fix: fix link appearance and click behavior (GSDK-821) [android]
Fix: update components to use form control theme (GSDK-835) [android]
Fix: ensure host app still receives touch events after session/activity changes (GSDK-198) [android]

🐇 Performance improvements

Fix: view hierarchy tracking is now "async" and won't interfere with the main thread (GSDK-819) [ios]

2.0.3 (Android, iOS, React Native) [2026-01-26]

🐛 Fixes

Fix: persist survey values when step-navigating (GSDK-582) [android, ios]
Fix: hide buttons until text animation completes, if applicable (GSDK-780) [android, ios]
Fix: popover overlaps system bars because we were not consuming WindowInsets from host app appropriately (GSDK-784) [android]
Fix: crash occurring on transition to a new activity that has enableEdgeToEdge() by waiting for root view to be attached to window (GSDK-768) [android]
Fix: ensure Modal Guides & Surveys are properly dismissed when shutdown() is called (GSDK-790) [ios]
Fix: update default content alignment to leading GSDK-796 [ios]
Fix: identify containerView as EngagementWindow to dismiss keyboard as needed GSDK-797 [ios]
Fix: expand nudge to show Other textfield without scrolling (GSDK-779) [ios]
Fix: internal engagement android dependency version is incorrectly set [rn]

2.0.2 (iOS) [2026-01-09]

🐛 Fixes

Fix: compile SDK framework with Xcode 16.2 / Swift 6.0.3 for broader compatiblity (GSDK-786) [ios]

2.0.1 (Android, iOS, React Native) [2026-01-07]

✨ Features

Feat: add ignoreAnalyticsAutomaticScreenTracking option to AmplitudeInitOptions to configure default Engagement SDK behavior for automatic screen tracking (GSDK-750) [android, ios]

🐛 Fixes

Fix: reset animation queue when nudge disappears (GSDK-518) [android]
Fix: crash in debug mode when used without calling "boot" on the SDK [android, ios]
Fix: ensure element selector and preview mode can be started when the other is active (GSDK-717) [ios]
Fix: ignore Amplitude Analytics automatic screen tracking by default in Engagement SDK (GSDK-781) [android, ios]

2.0.0 (Android, iOS, React Native) [2026-01-02]

🚨 Breaking Changes

AmplitudeEngagement is now an interface rather than a class, and the options and apiKey are no longer accessible [android]
AmplitudeInitOptions.Options has been removed and logLevel now lives at the top level of the options object [android, ios]
handlePreviewLinkIntent is deprecated, use handleLinkIntent instead (GSDK-322) [android]

✨ Features

Feat: add support for share links (GSDK-322) [android, ios]
Feat: add support for custom tooltip size (GSDK-353) [android, ios]
Feat: add support for serverZone, serverUrl, cdnUrl, mediaUrl, logLevel and locale init options (GSDK-767) [rn]

🐛 Fixes

Fix: pin visibility logic and mask interactions (GSDK-748) [android, ios]
Fix: allow banner content to expand vertically for tablet (GSDK-759) [ios]
Fix: add finite checks before using actual content size in constraints (GSDK-761) [ios]
Fix: maintain status bar visibility state when nudge shows (GSDK-758) [ios]
Fix: fix arrow misalignment on scrolled pins (GSDK-725) [ios]
Fix: gracefully handle failure to initialize mobile SDK, instead of crashing host app (GSDK-775) [android]
Fix: fix theming for step counter size and background color (GSDK-538) [android]
Fix: correctly handle "null" user and device IDs (FOO-2908) [android]
Fix: remove isObscuredByPresentedViewController check for target view visibility (GSDK-720) [ios]
Fix: tooltip is re-openable after using the "close" button to close it (GSDK-776) [ios]
Fix: properly apply drop shadow to Guide/Survey cards from theme (GSDK-772) [android, ios]
Fix: trigger display of matching guide/survey (if any) when user properties are updated via "_setUserProperties" (FOO-2911) [ios]
Fix: React Native plugin automatically sets serverZone based on the server zone used for Amplitude initialization (GSDK-767) [rn]

🐇 Performance improvements

Fix: event forwarding from Amplitude Analytics to G+S SDK is now "async" and won't interfere with the main thread (GSDK-763) [ios]

1.8.1 (iOS) [2025-12-04]

🐛 Fixes

Fix: update default title+text alignment to leading (GSDK-733) [ios]
Fix: bug causing app crash when Foundation.Data is used as an event property value (GSDK-736) [ios]

1.8.0 (Android, iOS, React Native) [2025-11-26]

✨ Features

Feat: update nudges to be scrollable for long content (GSDK-693) [ios]
Feat: track nudge engagement event with link source (GSDK-144) [android, ios]
Feat: respect modal height setting for carousels+modals on tablets [android, ios]

🐛 Fixes

Fix: fix nps button height (GSDK-708) [android]
Fix: re-render mask + target view on device orientation changes (GSDK-441) [ios]
Fix: use theme background color for top+bottom of Carousel (GSDK-731) [android]
Fix: background mask for pins flickers when advancing between steps (GSDK-660) [ios]
Fix: guide renders in top-left corner briefly before being moved to correct location (GSDK-718) [ios]
Fix: drop shadows on form factors is clipped and duplicated by Surface (GSDK-259) [android]
Fix: add support for conditional actions on button blocks (GSDK-726) [ios]
Fix: update spacing between ctas (GSDK-734) [android]

1.7.0 (Android, iOS, React Native) [2025-11-18]

🐛 Fixes

Fix: type error when using the Engagement Analytics Plugin with "amplitude.add(...)" (GSDK-698) [rn]
Fix: Guide title incorrectly center-aligned when left alignment was configured (GSDK-701) [android]
Fix: Allow underscore ("_") separated font files on Android (GSDK-701) [android]
Fix: Use correct corner radius and outer padding when rendering Guide (GSDK-701) [android]
Fix: app is unresponsive after displaying StoreKit content (for example, manageSubscriptionsSheet) (GSDK-699) [ios]

1.6.1 (Android, iOS, React Native) [2025-11-13]

🐛 Fixes

Fix: update ordering of survey and media blocks (GSDK-689) [android, ios]
Fix: fix threading issue for uikit click element (GSDK-571) [ios]
Fix: fix nudge anchoring on custom nav bar behind transparent system nav bar (GSDK-664) [ios]
Fix: refactor view hierarchy scanning to improve performance on the Main thread [android]

1.6.0 (Android, iOS, React Native) [2025-11-07]

✨ Features

Feat: proxy support (GSDK-630) (go to Proxy) [android, ios]
Feat: support 4 new popover Guide positions (top-center, bottom-center, left-center, right-center) (FOO-2639) [android, ios]

🐛 Fixes

Fix: add debug logging to all SDK methods [android, ios]
Fix: proper handling of null or blank user IDs on boot (GSDK-681) [android]
Fix: theming fixes (incorrect colors, text alignment, popover Guide width, and so forth.) (GSDK-671) [android]
Fix: when pin target scrolls offscreen, guide should be displayed again when target re-appears (GSDK-651) [android]
Fix: on tablets, modal carousel max width in theme is used, rather than device's max-width (GSDK-633, GSDK-616) [ios, android]
Fix: stop showing previously previewed guide when initiating a new preview (GSDK-595) [ios]
Fix: ensure URLs opened in browser are opened on main UI thread (GSDK-652) [ios]
Fix: odd whitespace appears when Guide content is right-aligned (GSDK-647) [android]
Fix: automatically call shutdown() when the user ID is set to nil via Amplitude Analytics SDK (#436) [ios]
Fix: modal Guide moves from centered to top left of screen (GSDK-627) [ios]
Fix: app hangs when executing a callback via a CTA button (GSDK-458) [ios]
Fix: banners using text animations have blank text (GSDK-638) [ios]
Fix: tooltip markers not staying with their targeted element when scrolling vertically (GSDK-607) [ios]
Fix: tooltip appearing without pointer (GSDK-607) [ios]
Fix: user-driven dismissal of tooltip should NOT hide the tooltip marker (GSDK-607) [ios]
Fix: ensure user properties passed to analytics.identify are used for Guide user property interpolation (#415) [ios]
Fix: prevent flickering for tooltips and closed-by-default pins (GSDK-659) [ios]
Fix: allow pins to target navbar elements (GSDK-664) [ios]
Fix: close button ("x") padding uses value from theme (GSDK-661) [ios]
Fix: images sometimes not loading (GSDK-656) [ios]

1.5.2 (iOS, React Native) [2025-10-31]

Fix: crash when calling setUserId

1.5.1 (Android, iOS, React Native) [2025-10-30]

SDK breaking change: cleanup() and reboot() functions have been removed, use shutdown() instead [android, ios]
Fix: ensure shutdown() removes all active nudges from view [android, ios, rn]
Fix: ensure non-JSON-safe values are serializable [android, ios, rn]

1.5.0 (Android, iOS, React Native) [2025-10-21]

🚨 Breaking Changes

SDK breaking change: Require calling shutdown() before calling boot() with a new user ID [android, ios, rn]

✨ Features

Feat: custom font support (GSDK-578, GSDK-620) [android, ios]
Feat: Analytics plugin tracks changes to user ID (#355) [android]
Feat: support links and italics in Guide titles (GSDK-600) [android,ios]

🐛 Fixes

Fix: multiple crashes involving QuickJS (GSDK-640, GSDK-625) [ios]
Fix: crash when rendering Guides in Android apps with multiple Activity or "plain" Activity (for example, not AppCompatActivity) (GSDK-589) [android]
Fix: crash on preview when using Debugger (#337) [ios]
Fix: "arrow" for tooltip Guide not hiding when tooltip is closed (GSDK-609) [ios]
Fix: carousel Guide is correct size on large (tablet) screens (GSDK-616) [ios]
Fix: pin form factor "offset" positioning + alignment bugs (GSDK-593) [ios]
Fix: modal and popover Guide snaps to the top-left rather than remaining in the configured position (GSDK-627) [ios]
Fix: a race condition which could cause a Guide to be un-dismissable (#355) [android, ios, rn]
Fix: condition causing duplicate carousel Guides (GSDK-641) [android]
Fix: text animations not always rendering properly (GSDK-638) [ios]
Fix: issue causing Dark Mode theme to not be used, or incorrect colors to be used (GSDK-596, GSDK-612) [android, ios]
Fix: remove extra spacing when actions are hidden (GSDK-421) [android, ios]
Fix: possible issue with "smart delay" trigger (GSDK-605) [android]
Fix: Guide title font weight now defaults to semi-bold (GSDK-615) [ios]