On this page

Guides and Surveys Mobile SDK Changelog

3.6.0

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

Features

  • [Android] Updated the debug overlay UI (GSDK-932).
  • [iOS] [Android] Added debug support and bug report screens (GSDK-913).
  • [iOS] Added debug logs screen and bug report logs (GSDK-911).
  • [Flutter] [React Native] Added the updateLanguage SDK method (GSM-358).

Fixes

  • [iOS] [Android] Added support for multi-action CTAs in Guides and Surveys.
  • [iOS] [Android] Added support for conditional actions in Guides and Surveys.

3.5.0

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

Features

  • [Android] Updated the debug overlay UI (GSDK-932).
  • [Android] [React Native] Added support for HLS video playback on Android (GSDK-924).

Fixes

  • [Android] Repositioned the debug button so it stays on-screen after device rotation (GSDK-927).
  • [iOS] Fixed an abort signal crash in the super debugger (GSDK-928).
  • [iOS] Fixed sequence nudge rendering so text animations don't block each other (GSDK-909).
  • [Android] [React Native] [Flutter] Prevented duplicate class errors when a host app also depends on org.commonmark (GSDK-940).
  • [iOS] Applied font weight to form components and Markdown (GSDK-805).
  • [iOS] Mapped CSS system font keywords in theme font family settings to the system font (GSDK-805).
  • [iOS] Matched Markdown font weight to the web preview (GSDK-805).

Performance improvements

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

3.4.0

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

Features

  • [iOS] [Android] Added debugger support to launch any unarchived guide or survey (GSDK-893).
  • [iOS] [Android] Added debug mode to periodically reposition pins (GSDK-910).
  • [iOS] [Android] Added a debug mode telltale that indicates whether events come from and go to the G+S SDK (GSDK-912).
  • [iOS] Updated the debug overlay UI (GSDK-913).

Fixes

  • [iOS] Repositioned the debug button so it stays on-screen after device rotation (GSDK-927).

3.3.1

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

Fixes

  • [iOS] [Android] [React Native] Fixed an issue where the screen SDK method didn't work properly if called before the SDK fully initialized (GSDK-915, assistance-browser PR #1072).
  • [React Native] Removed a trailing comma to re-enable Swift 6.0 support.
  • [Android] [iOS] Matched survey content width to the nudge step type (GSDK-908).
  • [Android] Fixed banner sizing for phone landscape mode (GSDK-907).
  • [iOS] Faded in banner buttons after text animation completes (GSDK-904).
  • [iOS] [Android] [React Native] Removed an unnecessary one-second delay in the screen SDK method (GSDK-898).

3.3.0

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

Features

  • [iOS] Added theme support for rating button padding (GSDK-803).
  • [Android] [iOS] Faded in buttons after text animation and added image fade-in (GSDK-889).
  • [Android] [iOS] Refreshed the SDK when the app enters the foreground (GSDK-886).
  • [Android] [iOS] Replaced the reboot call with refresh on session change (GSDK-886).

Fixes

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

3.2.0

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

Features

  • [React Native] Allowed user_properties in the boot SDK method (GSDK-869).
  • [Android] Added theme support for line height (GSDK-820).
  • [Android] Added theme support for rating button padding (GSDK-822).
  • [Android] [iOS] Added theme support for form control and button shadows (GSDK-806, GSDK-824).

Fixes

  • [Android] Updated the step counter for multi-step pins (GSDK-876).
  • [iOS] Used currentParent instead of view when resolving the bar in the navigation hierarchy (GSDK-874).
  • [iOS] Deferred pin positioning to correct for layout timing (GSDK-868).
  • [Android] Fixed horizontal pin UI and positioning (GSDK-815).
  • [Android] [iOS] Improved in-app support for Vimeo and Loom videos (GSDK-338, GSDK-861).
  • [Android] Increased 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] Allowed null or blank user IDs on boot when a device ID exists (GSDK-732).

Fixes

  • [Android] [iOS] Fixed auto-advance logic (GSDK-859).
  • [iOS] Fixed a race condition that prevented pin nudge rendering until the view hierarchy updated (GSDK-827, GSDK-844).

3.0.0

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

Breaking changes

  • [iOS] Changed AmplitudeEngagement from a class to an interface. Create new instances with AmplitudeEngagementFactory.make instead of the AmplitudeEngagement constructor (GSDK-690).

Features

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

Fixes

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

2.1.1

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

Fixes

  • [React Native] Fixed a trailing comma issue that caused build errors with Swift compilers earlier than 6.1.
  • [iOS] Fixed a keyboard layout bug during iOS 26 device rotation (GSDK-632).
  • [Android] Restored the nudge keyboard after configuration change (GSDK-831).

2.1.0

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

Features

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

Fixes

  • [Android] [iOS] Fixed theming issues (GSDK-676).
  • [iOS] Displayed the Pin guide when it follows another guide in a Tour, which is a multi-step guide (GSDK-827).
  • [Android] Repositioned the nudge when the keyboard shows (GSDK-782).
  • [Android] Fixed link appearance and click behavior (GSDK-821).
  • [Android] Updated components to use the form control theme (GSDK-835).
  • [Android] Kept host app touch events working after session or activity changes (GSDK-198).

Performance improvements

  • [iOS] Moved view hierarchy tracking async so it doesn't interfere with the main thread (GSDK-819).

2.0.3

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

Fixes

  • [Android] [iOS] Persisted survey values when step-navigating (GSDK-582).
  • [Android] [iOS] Hid buttons until text animation completes, if applicable (GSDK-780).
  • [Android] Fixed popover overlap with system bars by consuming WindowInsets from the host app appropriately (GSDK-784).
  • [Android] Prevented a crash during transition to a new activity that has enableEdgeToEdge() by waiting for the root view to attach to the window (GSDK-768).
  • [iOS] Dismissed modal Guides and Surveys properly when shutdown() runs (GSDK-790).
  • [iOS] Updated default content alignment to leading (GSDK-796).
  • [iOS] Identified containerView as EngagementWindow to dismiss the keyboard as needed (GSDK-797).
  • [iOS] Expanded the nudge to show the Other text field without scrolling (GSDK-779).
  • [React Native] Fixed the internal Engagement Android dependency version.

2.0.2

Released January 9, 2026. Platforms: iOS.

Fixes

  • [iOS] Compiled the 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] Added the ignoreAnalyticsAutomaticScreenTracking option to AmplitudeInitOptions to configure default Engagement SDK behavior for automatic screen tracking (GSDK-750).

Fixes

  • [Android] Reset the animation queue when the nudge disappears (GSDK-518).
  • [Android] [iOS] Fixed a crash in debug mode when the SDK runs without boot.
  • [iOS] Allowed element selector and preview mode to start when the other mode is active (GSDK-717).
  • [Android] [iOS] Ignored 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] Changed AmplitudeEngagement from a class to an interface and removed access to options and apiKey.
  • [Android] [iOS] Removed AmplitudeInitOptions.Options; logLevel now lives at the top level of the options object.
  • [Android] Deprecated handlePreviewLinkIntent; use handleLinkIntent instead (GSDK-322).

Features

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

Fixes

  • [Android] [iOS] Fixed pin visibility logic and mask interactions (GSDK-748).
  • [iOS] Allowed banner content to expand vertically for tablet (GSDK-759).
  • [iOS] Added finite checks before using actual content size in constraints (GSDK-761).
  • [iOS] Maintained status bar visibility state when nudge shows (GSDK-758).
  • [iOS] Fixed arrow misalignment on scrolled pins (GSDK-725).
  • [Android] Handled failure to initialize the mobile SDK gracefully instead of crashing the host app (GSDK-775).
  • [Android] Fixed theming for step counter size and background color (GSDK-538).
  • [Android] Correctly handled null user and device IDs (FOO-2908).
  • [iOS] Removed the isObscuredByPresentedViewController check for target view visibility (GSDK-720).
  • [iOS] Reopened tooltip after the user closes it with the close button (GSDK-776).
  • [Android] [iOS] Applied drop shadow to Guide and Survey cards from the theme (GSDK-772).
  • [iOS] Triggered display of a matching guide or survey, if any, when _setUserProperties updates user properties (FOO-2911).
  • [React Native] Set serverZone automatically based on the server zone used for Amplitude initialization (GSDK-767).

Performance improvements

  • [iOS] Moved event forwarding from Amplitude Analytics to the G+S SDK async so it doesn't interfere with the main thread (GSDK-763).

1.8.1

Released December 4, 2025. Platforms: iOS.

Fixes

  • [iOS] Updated default title and text alignment to leading (GSDK-733).
  • [iOS] Fixed an app crash when Foundation.Data appears as an event property value (GSDK-736).

1.8.0

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

Features

  • [iOS] Made nudges scrollable for long content (GSDK-693).
  • [Android] [iOS] Tracked nudge engagement event with link source (GSDK-144).
  • [Android] [iOS] Respected modal height setting for carousels and modals on tablets.

Fixes

  • [Android] Fixed NPS button height (GSDK-708).
  • [iOS] Re-rendered mask and target view on device orientation changes (GSDK-441).
  • [Android] Used theme background color for the top and bottom of Carousel (GSDK-731).
  • [iOS] Prevented background mask for pins from flickering when advancing between steps (GSDK-660).
  • [iOS] Prevented guides from rendering in the top-left corner briefly before moving to the correct location (GSDK-718).
  • [Android] Fixed clipped and duplicated drop shadows on form factors in Surface (GSDK-259).
  • [iOS] Added support for conditional actions on button blocks (GSDK-726).
  • [Android] Updated spacing between CTAs (GSDK-734).

1.7.0

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

Fixes

  • [React Native] Fixed a type error when using the Engagement Analytics Plugin with amplitude.add(...) (GSDK-698).
  • [Android] Fixed Guide title center alignment when configured for left alignment (GSDK-701).
  • [Android] Allowed underscore-separated font files (GSDK-701).
  • [Android] Used correct corner radius and outer padding when rendering Guide (GSDK-701).
  • [iOS] Fixed app unresponsiveness after displaying StoreKit content, for example, manageSubscriptionsSheet (GSDK-699).

1.6.1

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

Fixes

  • [Android] [iOS] Updated ordering of survey and media blocks (GSDK-689).
  • [iOS] Fixed a threading issue for the UIKit click element (GSDK-571).
  • [iOS] Fixed nudge anchoring on custom navigation bars behind transparent system navigation bars (GSDK-664).
  • [Android] Refactored view hierarchy scanning to improve main thread performance.

1.6.0

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

Features

  • [Android] [iOS] Added proxy support (GSDK-630). Go to Proxy.
  • [Android] [iOS] Added support for four new popover Guide positions: top-center, bottom-center, left-center, and right-center (FOO-2639).

Fixes

  • [Android] [iOS] Added debug logging to all SDK methods.
  • [Android] Handled null or blank user IDs on boot (GSDK-681).
  • [Android] Fixed theming issues with incorrect colors, text alignment, and popover Guide width (GSDK-671).
  • [Android] Showed the guide again when the pin target reappears after scrolling offscreen (GSDK-651).
  • [iOS] [Android] Used theme modal carousel max width on tablets instead of device max width (GSDK-633, GSDK-616).
  • [iOS] Stopped showing previously previewed guides when initiating a new preview (GSDK-595).
  • [iOS] Opened URLs in browser on the main UI thread (GSDK-652).
  • [Android] Fixed odd whitespace when Guide content uses right alignment (GSDK-647).
  • [iOS] Called shutdown() automatically when the Amplitude Analytics SDK sets the user ID to nil (#436).
  • [iOS] Fixed modal Guide positioning when it moves from centered to the top left of the screen (GSDK-627).
  • [iOS] Fixed an app hang when executing a callback through a CTA button (GSDK-458).
  • [iOS] Fixed blank text in banners that use text animations (GSDK-638).
  • [iOS] Kept tooltip markers with their targeted element when scrolling vertically (GSDK-607).
  • [iOS] Fixed tooltip appearance without a pointer (GSDK-607).
  • [iOS] Kept user-driven tooltip dismissal from hiding the tooltip marker (GSDK-607).
  • [iOS] Used user properties passed to analytics.identify for Guide user property interpolation (#415).
  • [iOS] Prevented flickering for tooltips and closed-by-default pins (GSDK-659).
  • [iOS] Allowed pins to target navigation bar elements (GSDK-664).
  • [iOS] Applied theme value to close button (x) padding (GSDK-661).
  • [iOS] Fixed intermittent image loading (GSDK-656).

1.5.2

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

Fixes

  • [iOS] [React Native] Fixed a crash when calling setUserId.

1.5.1

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

Breaking changes

  • [Android] [iOS] Removed cleanup() and reboot(); use shutdown() instead.

Fixes

  • [Android] [iOS] [React Native] Removed all active nudges from view when shutdown() runs.
  • [Android] [iOS] [React Native] Serialized non-JSON-safe values.

1.5.0

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

Breaking changes

  • [Android] [iOS] [React Native] Required shutdown() before boot() when changing to a new user ID.

Features

  • [Android] [iOS] Added custom font support (GSDK-578, GSDK-620).
  • [Android] Tracked changes to user ID in the Analytics plugin (#355).
  • [Android] [iOS] Added support for links and italics in Guide titles (GSDK-600).

Fixes

  • [iOS] Fixed multiple crashes involving QuickJS (GSDK-640, GSDK-625).
  • [Android] Fixed a crash when rendering Guides in Android apps with multiple Activity or plain Activity, for example, not AppCompatActivity (GSDK-589).
  • [iOS] Fixed a crash on preview when using Debugger (#337).
  • [iOS] Fixed the tooltip Guide arrow not hiding when the tooltip closes (GSDK-609).
  • [iOS] Fixed carousel Guide sizing on large tablet screens (GSDK-616).
  • [iOS] Fixed pin form factor offset positioning and alignment bugs (GSDK-593).
  • [iOS] Fixed modal and popover Guide positioning when it snaps to the top-left instead of remaining in the configured position (GSDK-627).
  • [Android] [iOS] [React Native] Fixed a race condition that could make a Guide undismissible (#355).
  • [Android] Fixed a condition that caused duplicate carousel Guides (GSDK-641).
  • [iOS] Fixed text animation rendering issues (GSDK-638).
  • [Android] [iOS] Fixed Dark Mode theme application and incorrect colors (GSDK-596, GSDK-612).
  • [Android] [iOS] Removed extra spacing when actions hide (GSDK-421).
  • [Android] Fixed a possible issue with the smart delay trigger (GSDK-605).
  • [iOS] Set the Guide title font weight default to semi-bold (GSDK-615).

Was this helpful?