Clarity Packages Changelog

Android SDK Changelog

3.8.0 (December 16, 2025)

• [Feature] Support Jetpack Compose 1.9 and 1.10.

3.7.0 (December 3, 2025)

• [Feature] Added consent API to manage user consent for data collection.

3.6.1 (November 6, 2025)

• [BugFix] Fixed a font parsing issue that prevented the font from rendering and caused unexpected cache growth.

3.6.0 (October 23, 2025)

• [Enhancement] Improved Compose experience with higher playback fidelity and optimized screen capture performance.
• [Enhancement] Optimized user interactions capturing.

3.5.1 (September 22, 2025)

• [BugFix] Fix NullPointerException crash related to connectivity state listener.

3.5.0 (September 11, 2025)

• [Enhancement] Enhanced memory management.
• [BugFix] Minor bug fixes.

3.4.6 (December 31, 2025)

• [BugFix] Fixed minor memory leak.

3.4.5 (August 14, 2025)

• [Feature] Support Android 16 (API 36).
• [Enhancement] Enhanced playback fidelity.

3.4.4 (August 4, 2025)

• [Feature] Support multiple values for the same tag/variable key when using setCustomTag().

3.4.3 (July 15, 2025)

• [Enhancement] Memory usage optimizations.

3.4.2 (July 10, 2025)

• [BugFix] Enabled android.nonTransitiveRClass to address resource conflicts issues.
• [BugFix] Fixed bugs in supporting Compose 1.8.
• [BugFix] Fixed issues in fetching Clarity configs.

3.4.1 (June 29, 2025)

• [BugFix] Bug fixes and improvements.

3.4.0 (June 22, 2025)

• [Enhancement] Support hardware bitmaps capturing.

3.3.1 (June 15, 2025)

• [Enhancement] Enhanced visual fidelity.

3.3.0 (May 20, 2025)

• [BugFix] Resolved Java 11 incompatibility issues.
• [Enhancement] Reduced SDK dependencies to minimize conflicts.

3.2.2 (May 1, 2025)

• [BugFix] Addressed various minor bugs.

3.2.1 (April 20, 2025)

• [BugFix] Fixed a bug in uncaught exception tracking that occasionally led to crashes.

3.2.0 (April 10, 2025)

• [Enhancement] Significantly reduced memory consumption.
• [Enhancement] Optimized network consumption.
• [BugFix] Fixed web views bug Can't find variable: clearClarity.
• [BugFix] Addressed an issue that was causing a memory leak in web views.
• [Feature] Included JavaDocs with the SDK.

3.1.3 (January 29, 2025)

• [BugFix] Addressed an issue that was causing a memory leak.

3.1.2 (January 20, 2025)

• [BugFix] Addressed an issue that caused sporadic application crashes due to SocketExceptions.

3.1.1 (January 18, 2025)

• [BugFix] Addressed an issue that prevented certain applications from resolving Clarity dependency.

3.1.0 (January 8, 2025)

• [Feature] Support Android 15 (API 35).
• [Feature] Support Jetpack Compose 1.7 and 1.8.
• [BugFix] Addressed an issue that caused random application crashes.
• [BugFix] Fixed a bug related to capturing dialogs.

3.0.2 (December 31, 2024)

• [BugFix] Addressed an issue that caused random application crashes.
• [Enhancement] Upgraded kotlin to version 1.8.

3.0.1 (December 15, 2024)

• [Enhancement] Custom screen names specified through setCurrentScreenName() API fully replace displayed screen name.
• [BugFix] Addressed various minor bugs.

3.0.0 (November 24, 2024)

• [Breaking] The allowMeteredNetworkUsage, enableWebViewCapture, disableOnLowEndDevices, allowedActivities, disallowedActivities, maximumDailyNetworkUsageInMB and allowedDomains configuration options in ClarityConfig are moved to the Settings page on the Clarity dashboard.
• [Breaking] setOnNewSessionStartedCallback is renamed to setOnSessionStartedCallback to better represent its functionality as the callback can be invoked not only when a new Clarity session starts but also when an existing session resumes at app startup.
• [Feature] Introduced the startNewSession API to initiate new sessions.
• [Feature] Enabled setting custom screen name tags using setCurrentScreenName API.
• [Feature] Added the ability to send custom events to use with the new Smart Events feature.
• [Enhancement] Added support for keyboard visualization for composables.
• [BugFix] Addressed various minor bugs.

2.5.2 (September 29, 2024)

• [BugFix] Fixed minor bug related to java utils.

2.5.1 (August 28, 2024)

• [BugFix] Fixed a bug related to web views.

2.5.0 (July 15, 2024)

• [Feature] Support Jetpack Compose in clarity-compose package.

2.4.0 (July 1, 2024)

• [Enhancement] Significant optimizations for network consumption.
• [Enhancement] Significant reduction in number of network calls.
• [BugFix] Fixed a bug that caused incorrect visualization of some frames.
• [BugFix] Fixed a bug that caused some frames to be dropped due to an internal exception.
• [BugFix] Fixed a bug that caused some sections of session recordings to repeat within a recording.

2.3.0 (May 9, 2024)

• [Enhancement] Optimizations for capturing logic CPU consumption.
• [Feature] Supporting keyboard capturing.
• [Feature] Supporting back gesture capturing.
• [Feature] Added pause API to allow pausing Clarity capturing.
• [Feature] Added resume API to allow resuming Clarity capturing.
• [Feature] Added isPaused API to check whether clarity capturing is paused or not.

2.2.0 (March 18, 2024)

• [Enhancement] Significant optimization for capturing logic CPU consumption.
• [Feature] Supporting dialogues capturing.
• [Feature] Expose a configuration to set a daily network usage limit for Clarity.
• [Feature] Expose a different initialization function Clarity.initialize(activity, config) that enables late initialization (for example, after the activity is created and resumed). This allows the developers to initialize Clarity after their key application components loaded.

2.1.1 (December 21, 2023)

• [BugFix] Fixed a minor bug that prevented Clarity from starting in a certain scenario.

2.1.0 (December 19, 2023)

• [Feature] Support Android 14 (API 34).
• [Enhancement] Added necessary logic to prevent OOM errors.
• [Enhancement] Optimized for the application startup time.
• [Feature] Exposing setOnNewSessionStartedCallback API to set an onSessionStarted callback.
• [Feature] Exposing getCurrentSessionUrl API to retrieve the current active session URL.

2.0.0 (October 25, 2023)

• [Feature] Added the setCustomSessionId API to set a custom session ID.
• [Feature] Added the ability to limit capturing to certain screens through the configuration lists allowedActivities and disallowedActivities.
• [Feature] Added the configuration flag disableOnLowEndDevices to allow disabling Clarity on low-end devices.
• [Enhancement] Updated the capturing approach to enhance its efficiency and resiliency.
• [Breaking] Jetpack Compose screens aren't captured anymore. Expect an upcoming release with better support for Jetpack Compose.

1.3.3 (September 4, 2023)

• [Feature] Support sessions filtering on Device cores and memory.
• [Feature] Added the setCustomTag API to support tagging sessions with custom tags.
• [Enhancement] Enhanced memory management.
• [Enhancement] Enhanced web view styles capturing.

1.3.1 (June 22, 2023)

• [Enhancement] Improved SDK performance and efficiency.
• [Enhancement] Enhanced recording speed for apps with large fonts.
• [Enhancement] Updated heatmaps logic for a more accurate experience.
• [BugFix] Fixed a bug that affected the capture of Ionic/Cordova apps assets.
• [BugFix] Fixed a bug that caused frames to be dropped due to an internal exception.
• [Feature] Switched to Protobuf instead of moshi for better compatibility.

1.3.0 (May 22, 2023)

• [Enhancement] Improved web views capture component for better performance and reliability.
• [Enhancement] Added resilience to capture failures.
• [Feature] Added a new dashboard feature to filter by device specifications (cores & memory).
• [BugFix] Fixed a bug that affected the movement of input text boxes.
• [BugFix] Fixed a bug that caused a StackOverFlow exception in some apps.
• [BugFix] Fixed minor capture errors that stopped the SDK.
• [BugFix] Fixed a bug that prevented some events from being captured.
• [BugFix] Fixed a bug that caused the SDK to crash due to some hardware bitmap exceptions.

1.2.4 (May 09, 2023)

• [Enhancement] Invalid UserID is set as CustomUserID and UserID is set to a random value instead of throwing an exception.
• [Enhancement] Delayed SDK setup until dashboard configuration is retrieved.
• [Feature] Improved SDK initialization for offline device scenarios.

iOS SDK Changelog

Important

• Older versions (1.0.0 to 1.0.2, 2.0.0 to 2.2.3, and 3.0.0 to 3.0.4) rely on a deprecated CDN and are expected to fail to download by early April 2025.

• To prevent disruptions, update to the latest available version or the latest patch within your major release.

3.4.0 (December 23, 2025)

• [BugFix] Renamed LogLevel enum to ClarityLogLevel to avoid conflicts with similarly named enums in other libraries.

3.3.5 (December 4, 2025)

• [BugFix] Fixed an iOS crash triggered when opening the camera image picker, caused by an unimplemented ModeLoupeLayer.init(layer:) initializer.

3.3.4 (November 26, 2025)

• [BugFix] Fixed an issue that affected tap correlation with heatmaps.

3.3.3 (November 9, 2025)

• [BugFix] Fixed iOS 26 related crashes.

3.3.2 (November 4, 2025)

• [BugFix] Fixed iOS 26 related crashes.

3.3.1 (October 30, 2025)

• [BugFix] Fixed SwiftUI masking related bugs.

3.3.0 (October 28, 2025)

• [Feature] Supporting iOS 26.

3.2.0 (September 16, 2025)

• [Enhancement] Added support for visualizing keyboard input in UIKit.
• [BugFix] Fixed minor bugs.

3.1.1 (August 28, 2025)

• [BugFix] Fixed minor bugs.

3.1.0 (August 27, 2025)

• [Compatibility] Upgraded internal library dependencies.

3.0.19 (September 1, 2025)

• [BugFix] Fixed minor bugs.

3.0.18 (August 28, 2025)

• [BugFix] Fixed minor bugs.

3.0.17 (August 21, 2025)

• [BugFix] Fixed bugs related to version 3.0.15.

3.0.16 (August 18, 2025)

• [BugFix] Fixed minor bugs.

3.0.15 (August 14, 2025)

• [Enhancement] Improved accuracy of tap text detection.
• [Enhancement] Reduced main thread processing time for smoother performance.

3.0.14 (August 8, 2025)

• [BugFix] Fixed minor bugs.

3.0.13 (August 7, 2025)

• [BugFix] Fixed minor bugs.

3.0.12 (August 4, 2025)

• [Feature] Support multiple values for the same tag/variable key when using setCustomTag().

3.0.11 (July 28, 2025)

• [BugFix] Fixed layout inaccuracies and tap location errors in modal views.

3.0.10 (July 14, 2025)

• [Enhancement] Improved session recording fidelity.
• [Enhancement] Enhanced automatic detection of custom fonts in SwiftUI views.
• [Deprecation] Deprecated clarityFontNameHint() SwiftUI modifier.
• [BugFix] Fixed minor bugs.

3.0.9 (July 7, 2025)

• [Enhancement] Added CPU optimizations.
• [BugFix] Addressed various minor bugs.

3.0.8 (June 23, 2025)

• [Enhancement] Added visual capturing improvements for SwiftUI.

3.0.7 (March 19, 2025)

• [Enhancement] Improved stability by proactively handling errors, minimizing the likelihood of crashes.
• [BugFix] Fixed an issue where the Apple Pay button appeared larger than its actual size.

3.0.6 (March 5, 2025)

• [Enhancement] Enhanced text rendering accuracy.
• [BugFix] Fixed an issue that caused event capturing to stop after some time of app usage.
• [BugFix] Fixed a crash when PDFView is presented.
• [BugFix] Fixed an issue with clearClarity in WebViews.

3.0.5 (February 16, 2025)

• [Compatibility] Functionally identical to 3.0.4, but it was rebuilt to use a new CDN.

3.0.4 (February 3, 2025)

• [Compatibility] This release is functionally identical to 3.0.3, but it was rebuilt using Swift compiler version 5. This ensures compatibility with projects built using older versions of Xcode 15. No other changes are included in this release.

3.0.3 (January 23, 2025)

• [Enhancement] Added support for color gradients.
• [Enhancement] Improved multitouch handling.
• [BugFix] Fixed crashes caused by layer color issues.

3.0.2 (December 15, 2024)

• [Enhancement] Custom screen names specified through setCurrentScreenName() API fully replace displayed screen name.

3.0.1 (December 4, 2024)

• [BugFix] Fixed an issue that caused crashes on earlier versions of iOS 16 when using WebViews.
• [BugFix] Fixed a crash that occurred during the orientation transition of third-party video player implementations (for example, Brightcove).

3.0.0 (November 24, 2024)

• [Breaking] Removed the experimental feature flag for SwiftUI support, making it enabled by default.
• [Breaking] The allowMeteredNetworkUsage, enableWebViewCapture, and disableOnLowEndDevices configuration options in ClarityConfig are moved to the Settings page on the Clarity dashboard.
• [Breaking] setOnNewSessionStartedCallback is renamed to setOnSessionStartedCallback to better reflect its functionality, as the callback can be invoked not only when a new Clarity session starts but also when an existing session is resumed at app startup.
• [Feature] Introduced the startNewSession API to initiate new sessions.
• [Feature] Enabled setting custom screen name tags using setCurrentScreenName API.
• [Feature] Added the ability to allow or disallow capturing WebViews based on URL patterns defined on the Clarity dashboard.
• [Feature] Added the ability to send custom events to use with the new Smart Events feature.
• [Enhancement] Implemented the capturing of text content from tapped view elements.
• [Enhancement] Enhanced dead tap detection for SwiftUI views.
• [Enhancement] Added initial support for keyboard visualization.
• [BugFix] Addressed various minor bugs.

2.2.4 (February 13, 2025)

• [Compatibility] Functionally identical to 2.2.3, but it was rebuilt to use a new CDN.

2.2.3 (December 4, 2024)

• [BugFix] Fixed an issue that caused crashes on earlier versions of iOS 16 when using WebViews.

2.2.2 (November 17, 2024)

• [BugFix] Fixed a bug which caused crashes when AVPlayer was present on the screen.
• [BugFix] Fixed a bug which caused taps to appear in incorrect locations during session playback.

2.2.1 (October 30, 2024)

• [BugFix] Fixed a bug related to font data uploading.

2.2.0 (October 30, 2024)

• [Feature] Supporting iOS 18.

2.1.2 (September 12, 2024)

• [BugFix] Fixed a bug that caused UIGraphicsBeginImageContext() to crash in some apps.
• [BugFix] Fixed a bug that caused app layout changes when CarbonTabSwipeSegmentedControl component from CarbonKit library is used.

2.1.1 (September 10, 2024)

• [BugFix] Fixed a bug that caused crashes in React Native apps that use react-native-svg.

2.1.0 (August 21, 2024)

• [Feature] Implemented support for custom callbacks that trigger at the beginning of new Clarity sessions.
• [Enhancement] Optimized screen capturing by pausing during periods of inactivity.
• [Enhancement] Included privacy manifest.
• [BugFix] Fixed a bug that caused UIGraphicsBeginImageContext() to crash in some apps.
• [BugFix] Fixed a bug that caused app layout changes when CarbonTabSwipeSegmentedControl component from CarbonKit library is used.

2.0.0 (July 29, 2024)

• [Breaking] Dropped the optional fields from the Objective-C interface of ClarityConfig initializer in favor of field setter approach to maintain backwards compatibility for future releases.
• [Feature] Introducing experimental support for SwiftUI apps through the enableSwiftUI_Experimental flag.

1.0.3 (February 13, 2025)

• [Compatibility] Functionally identical to 1.0.2, but it was rebuilt to use a new CDN.

1.0.2 (August 28, 2024)

• [BugFix] Fixed a bug related to web views.

1.0.1 (July 22, 2024)

• [BugFix] Minor bug fixes.

1.0.0 (July 1, 2024)

• [Initial Release] First public release of the iOS SDK.

Flutter SDK Changelog

1.6.0 (November 9, 2025)

• [Feature] Added support for capturing gradient applied to widgets.

1.5.0 (November 2, 2025)

• [Feature] Added support for dynamic configurations to allow runtime changes to Clarity settings without requiring app updates.
• [Enhancement] Improved hit testing accuracy for certain complex widget hierarchies.

1.4.3 (October 13, 2025)

• [BugFix] Fixed an issue where heatmaps were not working correctly when using setScreenName API.

1.4.2 (September 22, 2025)

• [Feature] Support latest versions of dependencies.

1.4.1 (September 18, 2025)

• [BugFix] Fixed a rare issue that could cause session uploads to stop.

1.4.0 (September 3, 2025)

• [Feature] Added initialize API to manually initialize Clarity with more control over initialization timing.
• [Enhancement] Network optimizations for improved data upload performance.

1.3.2 (August 20, 2025)

• [BugFix] Fixed an issue causing VisibilityDetector's onVisibilityChanged to trigger more while using Clarity.

1.3.0 (August 10, 2025)

• [Feature] Capture keyboard interactions.
• [Feature] Capture tap text.
• [BugFix] Fixed an issue where selectable text was incorrectly masked.

1.2.0 (July 16, 2025)

• [Feature] Added pause API to pause the Clarity session capturing.
• [Feature] Added resume API to resume the Clarity session capturing.
• [Feature] Added isPaused API to check if the Clarity session is currently paused.
• [BugFix] Fixed capturing the current session when the Clarity Widget is removed from the widget tree.

1.1.0 (July 9, 2025)

• [Feature] Added setCustomUserId API to set a custom user id for session tracking.
• [Feature] Added setCustomTag API to add custom tags to sessions.
• [Feature] Added setCustomSessionId API to set a custom session id for tracking specific sessions.
• [Feature] Added setOnSessionStartedCallback API that gets the clarity session id as a parameter to allow developers to execute custom logic when a session starts.
• [Feature] Added getCurrentSessionUrl API to retrieve the current Clarity session URL.
• [Feature] Added sendCustomEvent API to send custom events for the session to use in Smart events and Funnels.
• [Feature] Added setCurrentScreenName API to set the current screen name for the current page.

1.0.0 (June 16, 2025)

• [Initial Release] First public release of the Flutter SDK.

React Native SDK Changelog

Important

• Older versions (3.0.0 to 3.1.1, 4.0.0 to 4.1.5) rely on deprecated iOS SDK versions and are expected to fail to download by early April 2025.

• To prevent disruptions, update to the latest available version or the latest patch within your major release.

4.5.2 (December 24, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.4.0.

4.5.1 (December 4, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.3.5.
• [BugFix] (iOS) Fixed an iOS crash triggered when opening the camera image picker, caused by an unimplemented ModeLoupeLayer.init(layer:) initializer.

4.5.0 (December 4, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.7.0.
• [Feature] Added consent API (Android only).

4.4.2 (November 30, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.3.4.
• [BugFix] (iOS) Fixed an issue that affected tap correlation with heatmaps.

4.4.1 (November 10, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.3.3.

4.4.0 (November 9, 2025)

• [Feature] Added setCustomTags API.
• [Enhancement] Upgraded native Android SDK to version 3.6.1.
• [Enhancement] Upgraded native iOS SDK to version 3.3.2.

4.3.3 (August 24, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.0.17.
• [BugFix] (iOS) Resolved a build issue with react-native v0.80.2 when prebuild is enabled.
• [BugFix] (iOS) Fixed bugs related to version 4.3.2.

4.3.2 (August 17, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.4.5.
• [Enhancement] Upgraded native iOS SDK to version 3.0.15.
• [BugFix] Resolved a build issue with react-native v0.81.0 on Android.

4.3.1 (July 7, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.4.1.
• [Enhancement] Upgraded native iOS SDK to version 3.0.9.
• [Enhancement] (Android) Support hardware bitmaps capturing.
• [Enhancement] (Android) Enhanced visual fidelity.
• [Enhancement] (iOS) Added CPU optimizations.
• [BugFix] (iOS) Addressed various minor bugs.

4.3.0 (May 21, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.3.0.

4.2.2 (May 1, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.2.2.

4.2.1 (April 20, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.2.1.

4.2.0 (April 13, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.2.0.
• [Enhancement] Upgraded native iOS SDK to version 3.0.7.

4.1.8 (March 5, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.0.6.
• [Enhancement] (iOS) Enhanced text rendering accuracy.
• [Enhancement] (iOS) Enhanced visual fidelity, including colors, borders, and backgrounds.
• [BugFix] (iOS) Fixed a crash when react-native-pdf views are presented.
• [BugFix] (iOS) Fixed an issue where Clarity SDK interfered with React Native's PanResponder.

4.1.7 (February 23, 2025)

• [BugFix] Fixed crashes in release mode caused by NSNull values being incompatible with Clarity's native interface in newer React Native versions.

4.1.6 (February 16, 2025)

• [Compatibility] Functionally identical to 4.1.5, but it includes an updated iOS native SDK version to ensure compatibility with the latest distribution changes.
• [Enhancement] Upgraded native iOS SDK to version 3.0.5.

4.1.5 (February 6, 2025)

• [BugFix] Resolved a build issue with react-native v0.77.0 on Android.

4.1.4 (January 29, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.1.3.

4.1.3 (January 23, 2025)

• [Enhancement] Upgraded native iOS SDK to version 3.0.3.

4.1.2 (January 20, 2025)

• [BugFix] Addressed an issue that caused sporadic application crashes due to SocketExceptions.
• [Enhancement] Upgraded native Android SDK to version 3.1.2.

4.1.1 (January 20, 2025)

• [BugFix] Addressed an issue that prevented certain applications from resolving Clarity Android dependency.
• [Enhancement] Upgraded native Android SDK to version 3.1.1.

4.1.0 (January 8, 2025)

• [Enhancement] Upgraded native Android SDK to version 3.1.0.
• [Enhancement] Enabled support for capturing modals.

4.0.5 (December 31, 2024)

• [BugFix] Addressed an issue that caused random application crashes.
• [Enhancement] Upgraded native Android SDK to version 3.0.2.

4.0.4 (December 15, 2024)

• [Enhancement] Custom screen names specified through setCurrentScreenName() API fully replace displayed screen name.
• [Enhancement] Upgraded native Android SDK to version 3.0.1.
• [Enhancement] Upgraded native iOS SDK to version 3.0.2.
• [BugFix] Addressed various minor bugs.

4.0.3 (December 4, 2024)

• [BugFix] Fixed an issue that caused crashes on earlier versions of iOS 16 when using WebViews.
• [BugFix] Fixed a crash that occurred during the orientation transition of third-party video player implementations (for example, Brightcove).
• [Enhancement] Upgraded native iOS SDK to version 3.0.1.

4.0.2 (December 1, 2024)

• [BugFix] This release only addresses an npm registry issue that prevented the installation of version 4.0.1. Both versions, 4.0.1 and 4.0.2, offer the same feature set and improvements.

4.0.1 (November 24, 2024)

• [Breaking] npm package is renamed to @microsoft/react-native-clarity.
• [Breaking] Removed the experimental feature flag for iOS support, making it enabled by default.
• [Breaking] The allowMeteredNetworkUsage, enableWebViewCapture, allowedDomains, disableOnLowEndDevices, and maximumDailyNetworkUsageInMB configuration options in ClarityConfig are moved to the Settings page on the Clarity dashboard.
• [Feature] Introduced the startNewSession API to initiate new sessions.
• [Feature] Enabled setting custom screen name tags using setCurrentScreenName API.
• [Feature] Added the ability to allow or disallow capturing WebViews based on URL patterns defined on the Clarity dashboard.
• [Feature] Added the ability to send custom events to use with the new Smart Events feature.
• [Enhancement] Upgraded native iOS SDK to version 3.0.0.
• [Enhancement] Upgraded native Android SDK to version 3.0.0.
• [BugFix] Addressed various minor bugs.

3.1.2 (February 23, 2025)

• [Compatibility] Functionally identical to 3.1.1, but it includes an updated iOS native SDK version to ensure compatibility with the latest distribution changes.
• [Enhancement] Upgraded native iOS SDK to version 2.2.4.

3.1.1 (October 30, 2024)

• [Enhancement] Upgraded native iOS SDK to version 2.2.1.

3.1.0 (October 30, 2024)

• [Feature] Supporting iOS 18.
• [Enhancement] Upgraded native iOS SDK to version 2.2.0.

3.0.5 (October 24, 2024)

• [BugFix] Resolved a build issue with the new React Native architecture on iOS.

3.0.4 (September 12, 2024)

• [Enhancement] Upgraded native iOS SDK to version 2.1.2.

3.0.3 (September 10, 2024)

• [Enhancement] Upgraded native iOS SDK to version 2.1.1.

3.0.2 (September 9, 2024)

• [Enhancement] Upgraded native iOS SDK to version 2.1.0.

3.0.1 (July 22, 2024)

• [Enhancement] Upgraded native Android SDK to version 2.4.0.

3.0.0 (July 1, 2024)

• [Breaking] Installing Clarity alongside old versions of react-native-svg (< 14.x) is no longer allowed due to incompatibility issues.
• [Feature] Introducing experimental support for iOS (enableIOS_experimental flag).
• [Enhancement] Significant optimizations for network consumption.
• [Enhancement] Significant reduction in number of network calls.
• [BugFix] Fixed a bug that caused incorrect visualization of some frames.
• [BugFix] Fixed a bug that caused some frames to be dropped due to an internal exception.
• [BugFix] Fixed a bug that caused some sections of session recordings to repeat within a recording.

2.3.0 (May 9, 2024)

• [Enhancement] Optimizations for capturing logic CPU consumption.
• [Feature] Supporting keyboard capturing.
• [Feature] Supporting back gesture capturing.
• [Feature] Added the pause API to allow pausing Clarity capturing.
• [Feature] Added the resume API to allow resuming Clarity capturing.
• [Feature] Added the isPaused API to check whether clarity capturing is paused or not.

2.2.1 (March 19, 2024)

• [Enhancement] Significant optimization for capturing logic CPU consumption.
• [Feature] Supporting dialogues capturing.
• [Feature] Expose a configuration to set a daily network usage limit for Clarity.

2.1.0 (December 22, 2023)

• [Feature] Support Android 14 (API 34).
• [Enhancement] Added necessary logic to prevent OOM errors.
• [Enhancement] Optimized for the application startup time.
• [Feature] Exposing an API to retrieve the current active session URL.
• [BugFix] Accept null as a legitimate value for the setCurrentScreenName function to clear the current screen name.

2.0.0 (November 6, 2023)

• [Breaking] Updated the initialize() API arguments to take configurations in an object instead of taking them separately.
• [Feature] Added the setCustomSessionId API to set a custom session ID.
• [Feature] Added the configuration flag disableOnLowEndDevices to allow disabling Clarity on low-end devices.
• [BugFix] Updated the capturing approach to fix issues faced by some customers related to edit text fields.
• [BugFix] Fixed issues relating to setCustomUserId not working consistently.

1.0.1 (September 6, 2023)

• [Feature] Added the setCustomTag API to support tagging sessions with custom tags.
• [Feature] Added the setCurrentScreenName API to support setting current screen name, which enables filtering on a certain screen on the dashboard.

Cordova/Ionic SDK Changelog

3.0.0 (May 22, 2025)

• [Breaking] npm package is renamed to @microsoft/cordova-clarity.
• [Breaking] The allowMeteredNetworkUsage, enableWebViewCapture, allowedDomains, disableOnLowEndDevices, and maximumDailyNetworkUsageInMB configuration options in ClarityConfig are moved to the Settings page on the Clarity dashboard.
• [Feature] Added the ability to allow or disallow capturing WebViews based on URL patterns defined on the Clarity dashboard.
• [Feature] Support Android 15 (API 35).
• [Enhancement] Upgraded native Android SDK to version 3.3.0.
• [Enhancement] Significantly reduced memory consumption.
• [Enhancement] Optimized network consumption.
• [BugFix] Addressed various minor bugs.

2.3.0 (May 9, 2024)

• [Enhancement] Optimizations for capturing logic CPU consumption.
• [Feature] Supporting keyboard capturing.
• [Feature] Supporting back gesture capturing.
• [Feature] Added the pause API to allow pausing Clarity capturing.
• [Feature] Added the resume API to allow resuming Clarity capturing.
• [Feature] Added the isPaused API to check whether clarity capturing is paused or not.

2.2.0 (March 18, 2024)

• [Enhancement] Significant optimization for capturing logic CPU consumption.
• [Feature] Supporting dialogues capturing.
• [Feature] Expose a configuration to set a daily network usage limit for Clarity.

2.1.0 (December 22, 2023)

• [Feature] Support Android 14 (API 34).
• [Enhancement] Added necessary logic to prevent OOM errors.
• [Enhancement] Optimized for the application startup time.
• [Feature] Exposing an API to retrieve the current active session URL.

2.0.0 (November 8, 2023)

• [Breaking] Updated the initialize() API arguments to take configurations in an object instead of taking them separately.
• [Feature] Added the setCustomSessionId API to set a custom session ID.
• [Feature] Added the configuration flag disableOnLowEndDevices to allow disabling Clarity on low-end devices.
• [BugFix] Fixed issues relating to setCustomUserId not working consistently.

1.0.1 (September 7, 2023)

• [Feature] Added the setCustomTag API to support tagging sessions with custom tags.

Visit Clarity

Demo

Sign in

Blog