On this page

Guides and Surveys Mobile SDK Changelog

3.8.0

Released May 7, 2026. Platforms: Android, iOS, React Native, Flutter.

Features

  • [iOS] [Android] Support for nudges that trigger after N events in a session (GSW-454).

Fixes

  • [Android] Block TalkBack focus on background elements behind nudge (GSM-1018).
  • [Android] Show selected debug nudge after device rotation instead of original debug nudge (GSDK-937).
  • [Android] Add top safe area padding for banner (GSM-1033).
  • [iOS] Use actualContentSize to position pin arrow (GSM-1040).
  • [iOS] Changing font size when guide/survey is rendered causes elements to become non-tappable (GSM-899).
  • [iOS] Position anchorable nudge UI on main thread after JS callback (GSM-1041).

3.7.0

Released April 28, 2026. Platforms: Android, iOS, React Native, Flutter.

Features

  • [iOS] [Android] Show alert if user attempts to exit bug report before submitting (GSDK-945).
  • [iOS] [Android] [Flutter] [React Native] Add autoRefreshInterval to init options and deprecate passing it via boot options (GSM-1014).
  • [Android] Add debug logs screen and bug report logs (GSDK-911).

Fixes

  • [iOS] Block VoiceOver focus on background elements behind nudge (GSM-1018).
  • [iOS] Lead-align close button when title is trailing-aligned (GSM-1019).
  • [Android] Update text animation to continue after device rotation (GSDK-923).

3.6.0

Released April 15, 2026. Platforms: Android, iOS, React Native, Flutter.

Features

  • [Android] Update UI for debug overlay (GSDK-932).
  • [iOS] [Android] Add debug support and bug report screens (GSDK-913).
  • [iOS] Add debug logs screen and bug report logs (GSDK-911).
  • [Flutter] [React Native] Add updateLanguage SDK method to Flutter & React Native (GSM-358).

Fixes

  • [iOS] [Android] Support for multi-action CTAs in Guides & Surveys.
  • [iOS] [Android] Support for conditional actions in Guides & Surveys.

3.5.0

Released April 9, 2026. Platforms: Android, iOS, React Native, Flutter.

Features

  • [Android] Update UI for debug overlay (GSDK-932).
  • [Android] [React Native] Add support for HLS video playback for Android (GSDK-924).

Fixes

  • [Android] Reposition debug button so it's not off-screen on device rotation (GSDK-927).
  • [iOS] Fix abort signal crash in super debugger (GSDK-928).
  • [iOS] Fix sequence nudge rendering so text animations don't block each other (GSDK-909).
  • [Android] [React Native] [Flutter] Potential duplicate class errors when a host app also depends on org.commonmark (GSDK-940).
  • [iOS] Ensure font weight is applied to form components and markdown (GSDK-805).
  • [iOS] When CSS system font keywords are specified as the font family in theme, use the system font (GSDK-805).
  • [iOS] Ensure font weight in markdown matches web preview (GSDK-805).

Performance improvements

  • [iOS] Reduce SDK bundle size by ~500KB by using variable fonts (GSDK-805).

3.4.0

Released March 31, 2026. Platforms: Android, iOS, React Native.

Features

  • [iOS] [Android] Launch any unarchived guide or survey via debugger (GSDK-893).
  • [iOS] [Android] Add debug mode to periodically reposition pins (GSDK-910).
  • [iOS] [Android] Add debug mode "telltale" to indicate whether events are from and to the G+S SDK (GSDK-912).
  • [iOS] Update UI for debug overlay (GSDK-913).

Fixes

  • [iOS] Reposition debug button so it's not off-screen on device rotation (GSDK-927).

3.3.1

Released March 23, 2026. Platforms: Android, iOS, React Native.

Fixes

  • [iOS] [Android] [React Native] Fix issue causing SDK method screen to not work properly if it was called before the SDK is fully initialized (GSDK-915, assistance-browser PR #1072).
  • [React Native] Remove trailing comma to re-enable Swift 6.0 support.
  • [Android] [iOS] Fix survey content width to match nudge step type (GSDK-908).
  • [Android] Fix banner sizing for phone landscape mode (GSDK-907).
  • [iOS] Fade in banner buttons after text animation completes (GSDK-904).
  • [iOS] [Android] [React Native] Remove unnecessary 1 second delay in screen SDK method (GSDK-898).

3.3.0

Released March 17, 2026. Platforms: Android, iOS, React Native.

Features

  • [iOS] Add theme support for rating button padding (GSDK-803).
  • [Android] [iOS] Fade in buttons after text animation, and add image fade-in (GSDK-889).
  • [Android] [iOS] Refresh SDK on app foregrounded (GSDK-886).
  • [Android] [iOS] Replace reboot call with refresh on session change (GSDK-886).

Fixes

  • [Android] [iOS] Fix animated text showing link syntax while in-progress (GSDK-601).
  • [Android] Fix stuck text when coroutine cancelled mid-animation (GSDK-891).
  • [iOS] Fix misaligned and unclosable tooltip with image (GSDK-890).
  • [iOS] Fix undismissible star and number surveys (GSDK-906).

3.2.0

Released March 6, 2026. Platforms: Android, iOS, React Native.

Features

  • [React Native] Allow "user_properties" to be passed into "boot" SDK method (GSDK-869).
  • [Android] Add theme support for line height (GSDK-820).
  • [Android] Add theme support for rating button padding (GSDK-822).
  • [Android] [iOS] Add theme support form control and button shadows (GSDK-806, GSDK-824).

Fixes

  • [Android] Update step counter for multi-step pins (GSDK-876).
  • [iOS] Use currentParent instead of view when resolving bar in nav hierarchy (GSDK-874).
  • [iOS] Defer pin positioning to correct for layout timing (GSDK-868).
  • [Android] Fix horizontal pin UI and positioning (GSDK-815).
  • [Android] [iOS] Improve in-app support for vimeo and loom videos (GSDK-338, GSDK-861).
  • [Android] Increase nudge width for number surveys with nps-format buttons (GSDK-833).

3.1.1

Released February 23, 2026. Platforms: Android, iOS, React Native.

Fixes

  • [Android] [iOS] Reset survey responses on done or dismiss (GSDK-854).

3.1.0

Released February 13, 2026. Platforms: Android, iOS, React Native.

Features

  • [Android] [iOS] [React Native] On boot, allow "user ID" to be null or blank as long as device ID is specified (GSDK-732).

Fixes

  • [Android] [iOS] Fix auto-advance logic (GSDK-859).
  • [iOS] Race condition causing pin nudge to be unable to render until the view hierarchy is updated (GSDK-827, GSDK-844).

3.0.0

Released February 11, 2026. Platforms: Android, iOS, React Native.

Breaking changes

  • [iOS] 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).

Features

  • [Android] [iOS] [React Native] Add SDK methods disable which temporarily hides any displayed guides or surveys and enable which shows them again (GSDK-513).
  • [React Native] Add SDK method shutdown to React Native SDK binding (GSDK-769).
  • [Android] [iOS] [React Native] Add Minimum SDK version support to App Management so older SDK versions don't initialize Guides and Surveys.

Fixes

  • [Android] [iOS] Fix theming issues (GSDK-845, GSDK-847).
  • [Android] Fix tap outside to close behavior for modals (GSDK-850).

2.1.1

Released February 2, 2026. Platforms: Android, iOS, React Native.

Fixes

  • [React Native] Trailing comma issue causing build error on Swift compiler less than version 6.1.
  • [iOS] Fix keyboard layout bug during iOS 26 device rotation (GSDK-632).
  • [Android] Restore nudge keyboard after configuration change (GSDK-831).

2.1.0

Released February 2, 2026. Platforms: Android, iOS, React Native.

Features

  • [Android] [iOS] Add support for autoRefreshIntervalSeconds option to AmplitudeBootOptions to configure the auto-refresh interval for the SDK (GSDK-799).
  • [Android] [iOS] Add SDK method setAutoRefreshInterval to configure the auto-refresh interval for the SDK on the fly (GSDK-799).
  • [Android] [iOS] Add SDK method refresh to manually trigger a refresh of targeting data (GSDK-799).

Fixes

  • [Android] [iOS] Fix theming issues (GSDK-676).
  • [iOS] Ensure Pin guide is displayed when it follows another guide in a Tour (a multi-step guide) (GSDK-827).
  • [Android] Reposition nudge when keyboard shows (GSDK-782).
  • [Android] Fix link appearance and click behavior (GSDK-821).
  • [Android] Update components to use form control theme (GSDK-835).
  • [Android] Ensure host app still receives touch events after session/activity changes (GSDK-198).

Performance improvements

  • [iOS] View hierarchy tracking is now "async" and won't interfere with the main thread (GSDK-819).

2.0.3

Released January 26, 2026. Platforms: Android, iOS, React Native.

Fixes

  • [Android] [iOS] Persist survey values when step-navigating (GSDK-582).
  • [Android] [iOS] Hide buttons until text animation completes, if applicable (GSDK-780).
  • [Android] Popover overlaps system bars because we were not consuming WindowInsets from host app appropriately (GSDK-784).
  • [Android] Crash occurring on transition to a new activity that has enableEdgeToEdge() by waiting for root view to be attached to window (GSDK-768).
  • [iOS] Ensure Modal Guides & Surveys are properly dismissed when shutdown() is called (GSDK-790).
  • [iOS] Update default content alignment to leading GSDK-796.
  • [iOS] Identify containerView as EngagementWindow to dismiss keyboard as needed GSDK-797.
  • [iOS] Expand nudge to show Other textfield without scrolling (GSDK-779).
  • [React Native] Internal engagement Android dependency version is incorrectly set.

2.0.2

Released January 9, 2026. Platforms: iOS.

Fixes

  • [iOS] Compile SDK framework with Xcode 16.2 / Swift 6.0.3 for broader compatibility (GSDK-786).

2.0.1

Released January 7, 2026. Platforms: Android, iOS, React Native.

Features

  • [Android] [iOS] Add ignoreAnalyticsAutomaticScreenTracking option to AmplitudeInitOptions to configure default Engagement SDK behavior for automatic screen tracking (GSDK-750).

Fixes

  • [Android] Reset animation queue when nudge disappears (GSDK-518).
  • [Android] [iOS] Crash in debug mode when used without calling "boot" on the SDK.
  • [iOS] Ensure element selector and preview mode can be started when the other is active (GSDK-717).
  • [Android] [iOS] Ignore Amplitude Analytics automatic screen tracking by default in Engagement SDK (GSDK-781).

2.0.0

Released January 2, 2026. Platforms: Android, iOS, React Native.

Breaking changes

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

Features

  • [Android] [iOS] Add support for share links (GSDK-322).
  • [Android] [iOS] Add support for custom tooltip size (GSDK-353).
  • [React Native] Add support for serverZone, serverUrl, cdnUrl, mediaUrl, logLevel and locale init options (GSDK-767).

Fixes

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

Performance improvements

  • [iOS] Event forwarding from Amplitude Analytics to G+S SDK is now "async" and won't interfere with the main thread (GSDK-763).

1.8.1

Released December 4, 2025. Platforms: iOS.

Fixes

  • [iOS] Update default title+text alignment to leading (GSDK-733).
  • [iOS] Bug causing app crash when Foundation.Data is used as an event property value (GSDK-736).

1.8.0

Released November 26, 2025. Platforms: Android, iOS, React Native.

Features

  • [iOS] Update nudges to be scrollable for long content (GSDK-693).
  • [Android] [iOS] Track nudge engagement event with link source (GSDK-144).
  • [Android] [iOS] Respect modal height setting for carousels+modals on tablets.

Fixes

  • [Android] Fix nps button height (GSDK-708).
  • [iOS] Re-render mask + target view on device orientation changes (GSDK-441).
  • [Android] Use theme background color for top+bottom of Carousel (GSDK-731).
  • [iOS] Background mask for pins flickers when advancing between steps (GSDK-660).
  • [iOS] Guide renders in top-left corner briefly before being moved to correct location (GSDK-718).
  • [Android] Drop shadows on form factors is clipped and duplicated by Surface (GSDK-259).
  • [iOS] Add support for conditional actions on button blocks (GSDK-726).
  • [Android] Update spacing between ctas (GSDK-734).

1.7.0

Released November 18, 2025. Platforms: Android, iOS, React Native.

Fixes

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

1.6.1

Released November 13, 2025. Platforms: Android, iOS, React Native.

Fixes

  • [Android] [iOS] Update ordering of survey and media blocks (GSDK-689).
  • [iOS] Fix threading issue for uikit click element (GSDK-571).
  • [iOS] Fix nudge anchoring on custom nav bar behind transparent system nav bar (GSDK-664).
  • [Android] Refactor view hierarchy scanning to improve performance on the Main thread.

1.6.0

Released November 7, 2025. Platforms: Android, iOS, React Native.

Features

  • [Android] [iOS] Proxy support (GSDK-630) (go to Proxy).
  • [Android] [iOS] Support 4 new popover Guide positions (top-center, bottom-center, left-center, right-center) (FOO-2639).

Fixes

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

1.5.2

Released October 31, 2025. Platforms: iOS, React Native.

Fixes

  • [iOS] [React Native] Crash when calling setUserId.

1.5.1

Released October 30, 2025. Platforms: Android, iOS, React Native.

Breaking changes

  • [Android] [iOS] The cleanup() and reboot() functions have been removed, use shutdown() instead.

Fixes

  • [Android] [iOS] [React Native] Ensure shutdown() removes all active nudges from view.
  • [Android] [iOS] [React Native] Ensure non-JSON-safe values are serializable.

1.5.0

Released October 21, 2025. Platforms: Android, iOS, React Native.

Breaking changes

  • [Android] [iOS] [React Native] Require calling shutdown() before calling boot() with a new user ID.

Features

  • [Android] [iOS] Custom font support (GSDK-578, GSDK-620).
  • [Android] Analytics plugin tracks changes to user ID (#355).
  • [Android] [iOS] Support links and italics in Guide titles (GSDK-600).

Fixes

  • [iOS] Multiple crashes involving QuickJS (GSDK-640, GSDK-625).
  • [Android] Crash when rendering Guides in Android apps with multiple Activity or "plain" Activity (for example, not AppCompatActivity) (GSDK-589).
  • [iOS] Crash on preview when using Debugger (#337).
  • [iOS] "Arrow" for tooltip Guide not hiding when tooltip is closed (GSDK-609).
  • [iOS] Carousel Guide is correct size on large (tablet) screens (GSDK-616).
  • [iOS] Pin form factor "offset" positioning + alignment bugs (GSDK-593).
  • [iOS] Modal and popover Guide snaps to the top-left rather than remaining in the configured position (GSDK-627).
  • [Android] [iOS] [React Native] A race condition which could cause a Guide to be un-dismissable (#355).
  • [Android] Condition causing duplicate carousel Guides (GSDK-641).
  • [iOS] Text animations not always rendering properly (GSDK-638).
  • [Android] [iOS] Issue causing Dark Mode theme to not be used, or incorrect colors to be used (GSDK-596, GSDK-612).
  • [Android] [iOS] Remove extra spacing when actions are hidden (GSDK-421).
  • [Android] Possible issue with "smart delay" trigger (GSDK-605).
  • [iOS] Guide title font weight now defaults to semi-bold (GSDK-615).

Was this helpful?