---
title: Changelog - Flutter (classic)
description: The Contentsquare Flutter SDK changelog
lastUpdated: 07 April 2026
source_url:
  html: https://docs.contentsquare.com/en/flutter/changelog/
  md: https://docs.contentsquare.com/en/flutter/changelog/index.md
---

> Documentation index: https://docs.contentsquare.com/llms.txt
> Use this file to discover all available pages before exploring further.

The latest CSQ SDK is here! Learn how to [upgrade your app](https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/upgrade-from-cs-sdk/).

📬 Stay updated!

## 4.1.1 - 2026.03.19

* **Improvements:**
  * Extend Flutter version support to include 3.27.0 and later (previously 3.27.4+).

## 4.1.0 - 2026.02.27

* **Analytics:**
  * Introduce the Long Snapshot feature to capture and analyze long screens in the app, such as product listing pages or user profiles.

* **Native SDKs:**

  * Android: 4.43.8 → 4.44.0
  * iOS: 4.45.3 → 4.46.0

* **🚨 Minimum Flutter version**
  * Contentsquare plugin now requires Flutter SDK `3.27.4` or later

## 4.0.3 - 2026.02.03

* **Native SDKs:**
  * Android: 4.43.3 → 4.43.8

## 4.0.2 - 2026.01.29

* **Bug fix**
  * Session Replay: Fixed an issue that could cause `BackdropFilter` widgets to appear mispositioned in replays.

## 4.0.1 - 2025.12.11

* **Bug fix**

  * SessionReplay: Fixed an issue that could cause white screens to appear on iOS.

* **Native SDKs:**

  * iOS: 4.45.1 → 4.45.3

* **Dependencies:**

  * Updated protobuf dependency in `pubspec.yaml` to `>=2.0.0 <7.0.0`

## 4.0.0 - 2025.12.05

Breaking changes

* `ContentsquareRoot` widget has been removed.
* `autostart` is removed. From now on to start the SDK, you need to call `Contentsquare.start()`.
* `optIn` call is required to start tracking. By default, the SDK will not start tracking until `optIn` is called.
* All screenshots should be re-taken to ensure proper zoning functionality.
* `ContentsquareWebViewTrackerBuilder` widget has been removed.

- **WebView support:**

  * From now on, to track WebViews, use the `ContentsquareWebViewWrapper` widget as described in the [WebView documentation](https://docs.contentsquare.com/en/flutter/track-webviews/).

- **Zoning**

  * Screenshots and TVP computation were improved to enhance zoning accuracy.

- **Native SDKs:**

  * iOS: 4.43.0 → 4.45.1
  * Android: 4.41.0 → 4.43.3

- **🚨 Minimum Flutter version**

  * Contentsquare plugin now requires Flutter SDK `3.22.4` or later

## 3.19.3 - 2026.01.16

* **Bug fix**
  * Session Replay: Fixed an issue that could cause `BackdropFilter` widgets to appear mispositioned in replays.

## 3.19.2 - 2025.12.01

* **Native SDKs:**
  * iOS: 4.43.0 → 4.45.2

## 3.19.1 - 2025.10.08

* **Bug fix**
  * SessionReplay: Fixed an Android issue that could affect the positioning of certain elements.

## 3.19.0 - 2025.10.02

* **Analytics:**
  * Introduce *Heatmap* feature

* **Session Replay:**

  * Added new APIs to start Session Replay on demand
  * Introduction of Harmonised Masking in Closed Beta Phase

* **Native SDKs:**
  * Android: 4.40.0 → 4.41.0

* **🚨 Minimum Flutter version**
  * Contentsquare plugin now requires Flutter SDK `3.19.6` or later

## 3.18.0 - 2025.08.07

* **Native SDKs:**

  * iOS: 4.42.2 → 4.43.0
  * Android: 4.39.1 → 4.40.0

* **Session Replay:**

  * Support [`fl_chart` ↗](https://pub.dev/packages/fl_chart) widgets and masking
  * Support Image/Text remote masking configuration in the CSQ Console
  * Added new APIs to support Event-Triggered Replays

* **🚨 Minimum Flutter version announcement**
  * Starting with the next release (`3.19.0`), Contentsquare plugin will require Flutter SDK to be `3.19.0` or later

## 3.17.1 - 2025.06.27

* **Native SDKs:**
  * iOS: 4.42.0 → 4.42.2

## 3.17.0 - 2025.06.20

* **Session Replay**
  * Improve stability on very heavy screens

* **🚨 Minimum Flutter and iOS version change**

  * Contentsquare plugin now requires Flutter SDK `3.16.9` or later
  * Contentsquare plugin now requires iOS `13.0` or later

* **Native SDKs:**

  * iOS: 4.40.2 → 4.42.0
  * Android: 4.36.1 → 4.39.1

## 3.16.3 - 2025.05.28

* **Bug fix**
  * Android: Fixed an issue that could affect remote full masking based on the app version.

## 3.16.2 - 2025.03.19

* **Session Replay**

  * Support all `ExcludeSemantics` widgets
  * Support `IgnorePointer` and `AbsorbPointer` widgets

## 3.16.1 - 2025.03.13

* **Bug fix:**
  * Fix an Android bug where API changed in Android 15 crash with `java.lang.NoSuchMethodError` from `java.util.List`.
* **Native SDK update**
  * Android: 4.36.0 → 4.36.1

## 3.16.0 - 2025.02.21

* **Session Replay**

  * Support full remote masking configuration by APP/SDK versions through the CSQ Console
  * Support Session Replay gestures in the player's event stream
  * [Add the ability to mask `CustomPaint`](https://docs.contentsquare.com/en/flutter/session-replay/#masking-mechanisms)
  * Android Webviews in Session Replay have now the expected sizes

* **Screenshot**
  * Fix a crash that could occur when taking a screenshot on Android

* **API**
  * `Contentsquare.start` and `ContentsquareNavigatorObserver` are now officially supported. The `@experimental` annotation has been removed.

* **🚨 Minimum Flutter version announcement**

  * Starting with the next release (`3.17.0`), Contentsquare plugin will require iOS version to be `13.0` or later
  * Starting with the next release (`3.17.0`), Contentsquare plugin will require Flutter SDK to be `3.16.9` or later

* **Native SDK update**

  * iOS: 4.38.2 → 4.40.2
  * Android: 4.34.0 → 4.36.0

## 3.15.3 - 2025.02.04

* **Bug fix:**
  * Fixed a bug, where an improperly tracked tap could create an exception.

## 3.15.2 - 2025.01.22

* **Bug fix:**

  * Fixed a bug, when unable to zone bottom bar
  * Fixed a bug on iOS, when the webview zones become displaced when screenshot is scrolled
  * Fixed a bug, when bottom dialog shows up after the language changes

## 3.15.1 - 2024.12.11

* **Zoning**
  * Fixed a bug where ReliableTargets could be not properly tracked in some cases, when multiple lists containing a Reliable Target in the same index, are switched in the same area of the screen.

## 3.15.0 - 2024.12.04

* **🚨 Minimum Flutter version announcement**
  * Starting with the next release (`3.16.0`), Contentsquare plugin will require Flutter SDK `3.13.9` or later

* **Experience Analytics**
  * Introduce collection of Flutter errors feature

* **Session Replay**

  * Support Text widgets when they are wrapped with `Semantics` or contain `semanticsLabel`
  * Improve performance and stability
  * Support `Opacity` widget
  * Fix a bug in `onSessionReplayLinkChange` for android where the link is not updated after the app returns from background

* **Other**
  * Resolve an issue that could prevent building obfuscated Android applications with Android Gradle Plugin (AGP) versions 8.4.0 and later

Warning

Versions of the SDK earlier than 3.15.0 do not support AGP versions 8.4.0 and later. To ensure compatibility with AGP >= 8.4.0 , upgrade to Contentsquare Flutter SDK version 3.15.0 or later.

* **Native SDK update**

  * iOS: 4.37.2 → 4.38.2
  * Android: 4.33.2 → 4.34.0

## 3.14.159 - 2024.11.05

* **WebView support:**
  * Improve support for WebViews
* **Logging:**
  * Fix an issue where warning logs were incorrectly displayed as error logs
* **Dependencies:**
  * Updated protobuf dependency in `pubspec.yaml` to `>=2.0.0 <4.0.0`

## 3.14.1 - 2024.10.22

* **Privacy**
  * Fix a bug occurring to `resumeTracking` when `CSInApp` is enabled
* **Native SDKs:**
  * Android: 4.33.1 → 4.33.2

## 3.14.0 - 2024.10.17

* **API**

  * Adds `ContentsquareNavigatorObserver` to automatically track screen changes (as an [experimental](https://docs.contentsquare.com/en/flutter/experimental/) feature)
  * Adds `start` method to manually start the SDK (as an [experimental](https://docs.contentsquare.com/en/flutter/experimental/) feature)

* **Session Replay:**

  * Adds more fidelity in replays

    * Texts and icons have now high fidelity
    * Font uploading is no longer needed for android and iOS

* **🚨 Minimum Flutter version change**
  * Contentsquare plugin now requires Flutter SDK `3.10.6` or later

* **Native SDKs:**

  * iOS: 4.36.0 → 4.37.2
  * Android: 4.32.1 → 4.33.1

## 3.13.1 - 2024.09.24

* **🚨 Minimum Flutter version announcement**

  * Starting with the next release (`3.14`), Contentsquare plugin will requires Flutter SDK `3.10.1` or later

* **Analytics:**

  * Fix an issue occurring on iOS Zoning screenshot when a custom root `ViewController` is used

* **Session Replay:**

  * Fix an issue occurring in Session Replay when a `CustomPainter` animation is disposed

* **Native SDKs:**

  * iOS: 4.36.0 → 4.36.1

## 3.13.0 - 2024.09.13

* **WebViews**

  * Improved webViews tracking with the new widget `ContentsquareWebViewWrapper`

* **Native SDKs:**

  * iOS: 4.35.0 → 4.36.0
  * Android: 4.31.0 → 4.32.1

## 3.12.0 - 2024.08.14

* **Session Replay:**

  * Support dynamic `QualityLevels` in the `SessionReplay` (low, medium and high)

  * Improve `SessionReplay` performance

  * Fidelity improvements

    * Support `CustomPaint`
    * Support borders
    * Support checkboxes, radio buttons, and switches
    * Support SVG images (for `flutter_svg` package)
    * Additional support for `Decorations`

  * Fixed error that occurs when `RichText` is masked

* **Native SDKs:**

  * iOS: 4.33.1 → 4.35.0
  * Android: 4.29.1 → 4.31.0

## 3.11.1 - 2024.06.18

* **Native SDKs:**

  * iOS: 4.33.0 → 4.33.1
  * Android: 4.29.0 → 4.29.1

## 3.11.0 - 2024.06.11

* **Session Replay:**

  * Improve fidelity
  * Support images and gradient colors in `ShapeDecoration`

* **ApiErrors:**

  * Introduce a `gentle` HttpOverride
  * Fix a bug with tracking requests in `dio` package

* **Native SDKs:**

  * iOS: 4.32.0 → 4.33.0
  * Android: 4.28.0 → 4.29.0

## 3.10.0 - 2024.04.29

* **Session Replay:**
  * Added support for `WidgetSpan`

* **Native SDKs:**

  * iOS: 4.31.2 → 4.32.0
  * Android: 4.27.1 → 4.28.0

* **🚨 Minimum Flutter version change**
  * Contentsquare plugin now requires Flutter SDK 3.3.10 or later.

## 3.9.0 - 2024.04.02

* **Session Replay:**

  * Add public API: `onSessionReplayLinkChange` to listen to Session Replay URL changes during app lifecycle
  * Deprecate public API: `currentSessionReplayUrl`
  * Performance improvement in Android Session Replay
  * Partially support gradient colors in Session Replay as solid color
  * Fix a bug happening when CS in-app is opened while Session Replay is running, on Android
  * Fix a minor bug displaying a warning as an error during Session Replay

* **Platform support:**
  * Contentsquare SDK is now completely disabled on unsupported platforms (Desktop and Web) and non mobile apps can now be built safely.

* **Native SDKs:**

  * iOS: 4.30.2 → 4.31.2
  * Android: 4.26.0 → 4.27.1

## 3.8.0 - 2024.03.04

* **API:**
  * `forgetMe` has been deprecated

* **Session Replay:**

  * Fix a bug that could occur when using the `span` widget
  * Fix a bug that stops the Session Replay when translation animation is set to infinity, that could happen if BottomNavigationBar's selectedFontSize is set to 0

* **Analytics:**
  * Fix an issue in webviews using the tracking tag that impacted the launch of Analytics

* **Screenshot:**
  * Fixed a bug that could lead to a restart of the app state during the usage of CS in-app tool

* **Native SDKs:**

  * iOS: 4.29.1 → 4.30.2

  * Android: 4.24.1 → 4.26.0

    * ⚠️ `compileSdkVersion` requirement has fallen back to `33`
    * Added support to use ProGuard for minification and shrinking

## 3.7.0 - 2024.01.26

* **Screenshots:**

  * A bug provoking state restart while taking screenshots from CS in-app is fixed
  * A bug provoking state restart of ContentsquareRoot when displaying CS in-app is fixed

* **[Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/#configure-webviews)**

  * Fix an issue on Android Session Replays
  * Support of webviews was added to the Session Replay for both Android and iOS platforms (check the documentation for additional implementation steps)
  * From now on, the masking configuration can be changed dynamically during the Session Replay on the Flutter elements

* **Native SDKs:**

  * iOS: 4.27.0 → 4.29.1
  * Android: 4.23.1 → 4.24.1
    * ⚠️ `compileSdkVersion` should be bumped to `34`

Version 3.6.0 retraction

Version 3.6.0 of the Contentsquare Flutter plugin has been identified to contain a deployment issue for iOS. As a result, this version has been retracted and is no longer available for use. Upgrade to the [latest version](https://docs.contentsquare.com/en/flutter/).

## 3.5.1 - 2023.12.20

* **\[🚨 Maximum Flutter version]**
  * Add support of the latest Flutter version (3.16 and later)

## 3.5.0 - 2023.12.01

* **[API Errors:](https://docs.contentsquare.com/en/flutter/error-analysis/)**
  * Support of the `API Errors` feature has been added to Android platform

* **[Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/)**
  * Support of the `Session Replay` feature has been added to Android platform

* **[Reliable Targets](https://docs.contentsquare.com/en/flutter/reliable-targets/)**
  * Support of the `Reliable Targets` feature has been added to both Android and iOS platforms

* **[User Identifier](https://docs.contentsquare.com/en/flutter/session-replay/#send-user-identifier)**
  * Support of the `User Identifier` feature has been added to both Android and iOS platforms

* **Native SDKs:**

  * Android: 4.21.0 → 4.23.1
  * iOS: 4.25.0 → 4.27.0

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.4.0 - 2023.09.14

* **Custom Variables:**
  * Support of the `Custom Variables` feature has been added to Android

* **[API Errors:](https://docs.contentsquare.com/en/flutter/error-analysis/)**
  * Support of the `API Errors` feature has been added to iOS

* **[Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/)**
  * Minor fidelity improvements

* **Native SDKs:**

  * Android: 4.20.0 → 4.21.0
  * iOS: 4.24.0 → 4.25.0

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.3.0 - 2023.08.01

* **Native SDKs:**

  * Android: 4.19.0 → 4.20.0
  * iOS: 4.23.0 → 4.24.0

* **[Session Replay](https://docs.contentsquare.com/en/flutter/session-replay)**
  * Minor fidelity improvements

* **Custom Variables:**
  * Support of the Custom Variables feature has been added to iOS

* **API Errors:**
  * Added a log when API Errors collection is enabled or disabled in iOS (for future usage)

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.2.1 - 2023.07.04

* **Bug fix:**
  * Fixed an issue on Android, causing a crash during the initialization of the SDK. Bug was introduced since the release of 3.1.0

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.2.0 - 2023.06.30

* **Bug fix:** Fix critical bug for clients who use Flutter < 3.0 introduced in the CS SDK release 3.1.0

* **API**:
  * New method getter `currentSessionReplayUrl` (iOS Only)

* [Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/) fidelity improvements:

  * Shadows
  * Clipping
  * Radius
  * Transparency
  * Blur

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.1.0 - 2023.06.20

* **Native SDKs:**

  * Android: 4.18.1 → 4.19.0
  * iOS: 4.22.1 → 4.23.0

* [Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/) improvements:

  * Added icons support
  * Performance improvement for unmasked images

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 3.0.0 - 2023.05.17

Breaking change

Remove support for `sendTouchEvent`.

* **Native SDKs:**

  * Android: 4.17.0 → 4.18.1
  * iOS: 4.21.0 → 4.22.1

* [Session Replay](https://docs.contentsquare.com/en/flutter/session-replay/) feature is available for iOS only. For more information, reach out to your Contentsquare contact.

* **\[🚨 Maximum Flutter version]**

  * Currently, the maximum Flutter version supported by the plugin is `3.13.9`.
  * Support of the Flutter version 3.16 and later is added back in the plugin `3.5.1`. Update the plugin if you are using Flutter 3.16 or later.

## 2.3.0 - 2023.04.13

* **Native SDKs:**

  * Android: 4.16.0 → 4.17.0
  * iOS: 4.20.0 → 4.21.0

## 2.2.0 - 2023.03.09

* **Native SDKs:**
  * Android: 4.15.0 → 4.16.0

## 2.1.0 - 2023.03.02

* **Native SDKs:**
  * iOS: 4.18.0 → 4.20.0

## 2.0.1 - 2023.02.28

* **Bug fix:** Track Transactions now supports any value while it would previously fail if the given transaction value contained decimals.

## 2.0.0 - 2023.01.30

Breaking change

First party support for `webview_flutter` plugin has been removed for now. Use the generic webview tracking API in the meantime. See [the updated documentation](https://docs.contentsquare.com/en/flutter/track-webviews/#examples) for concrete implementation examples.

* **WebView Tracking:**

  * **\[🚨 Breaking Change 🚨] Feature:** You can now use the SDK with any version of the `webview_flutter` plugin. However to do so we had to remove the first party support for this plugin. You can still use the generic webview tracking API. See [the updated documentation](https://docs.contentsquare.com/en/flutter/track-webviews/#examples) for concrete implementation examples.
  * **\[🚨 Breaking Change 🚨] Refactoring:** `JavascriptChannel` has been renamed to `ContentsquareJavascriptChannel` to avoid naming conflicts with other plugins.
  * **Refactoring:** `tracker.initializeWebViewTracking` has been renamed to `tracker.startPageTracking`. Using `tracker.initializeWebViewTracking` is deprecated and will be removed in a future release.

## 1.3.2 - 2022.12.23

Data Breaking change

Screenshots for Android apps are not compatible with the previous versions and need to be retaken.

* **Native SDKs:**

  * Android: 4.14.0 → 4.15.0
  * iOS: 4.17.0 → 4.18.0

* **Fix:** Bump the lowest supported Dart SDK version from 2.12.0 to 2.15.0

## 1.3.1 - 2022.12.22 - Deprecated

Deprecation notice

This version is deprecated because it introduces an incompatibility between the screenshots API and the touch events API, which breaks the zoning analysis feature.

## 1.3.0 - 2022.11.24

* **Native SDKs:**

  * Android: 4.13.1 → 4.14.0
  * iOS: 4.13.0 → 4.17.0

## 1.2.0 - 2022.11.14

* **Screenshots:** Beta third-party WebView tracking support (see [flutter\_inappwebview ↗](https://pub.dev/packages/flutter_inappwebview))

## 1.1.0 - 2022.11.07

* **Screenshots:** Beta WebView tracking support (only for the [official WebView plugin ↗](https://pub.dev/packages/webview_flutter))

## 1.0.1 - 2022.10.31

* **Fix:** Update dependency of `contentsquare` on `contentsquare_plugin_interface`

## 1.0.0 - 2022.10.24 - Deprecated

⚠️ This version is deprecated due to bad dependency which prevents the plugin from compiling. Use the latest version of the plugin instead.

* **License:** License update

## 0.5.3 - 2022.07.13

* **Bug fix:** Fixed an issue on Android, where CS in-app features menu caused a crash while using the opt-out and opt-in operations
* **Native SDKs:** Android 4.11.0

## 0.5.2 - 2022.07.04

* **Error when building in profile mode:** Bump `compileSdkVersion` to 31 to support Gradle version >= `4.2.0`

## 0.5.1 - 2022.05.30

* **Screenshots:**
  * Stability improvement for `Navigator` pushed screens

## 0.5.0 - 2022.05.12

* **Screenshots:**

  * Fix issue on generating accurate targets for gestures
  * Only include widgets which are currently visible

* **Native SDKs:** Android 4.9.0 and iOS 4.13.0

## 0.4.2 - 2022.04.14

* **Screenshots:** Fixed an issue where screenshot captured was not rendering the right screen.
* **Gesture tracking:** Fixed an issue on our gesture detector that could cause an exception to be thrown in edge cases.
* **Native SDKs:** Android 4.8.0 and iOS 4.12.0

## 0.4.1 - 2022.03.25

* **Screenshots:** Fixed screenshot capture infinite loading on Android caused by WebView; fixed screenshot capture infinite loading on iOS caused by conflict with `background_locator` plugin; fixed visual bug with the app bar; fixed empty screenshot on iOS related to autostart disabled.
* **Native SDKs:** Android 4.8.0 and iOS 4.11.0

## 0.4.0 - 2022.03.01

* **Crash at app launch on Android:** Fixed a bug introduced crashing the app on Android, at app start.

## 0.3.0 - 2022.02.18

* **Gesture tracking:** Gesture tracking optimization; fixed issue preventing scrolling in WebView;
* **Screenshots:** Size Optimization.
* **Native SDKs:** Android 4.7.0 and iOS 4.11.0

## 0.2.3 - 2022.02.07

* **Native SDKs:** Android 4.7.0 and iOS 4.10.1

## 0.2.2 - 2022.01.13

* **Gesture tracking:** Fixed performance issue related to gesture tracking
* **Screenshots:** Support screenshot capture on iOS
* **Native SDKs:** Android 4.3.0 and iOS 4.10.0

## 0.2.1 - 2022.12.17

* **Gesture tracking:** Now support gesture tracking accurately.