---
title: Changelog - Flutter
description: The CSQ Flutter SDK changelog
lastUpdated: 11 March 2026
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/changelog/
  md: https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/changelog/index.md
---

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

📬 Stay updated!

## Opt-in to CSQ Experience Platform

Already using the CSQ SDK in standalone mode? Follow these steps to switch to CSQ Experience Platform and combine Experience Analytics and Product Analytics under a single data source.

CSQ Experience Platform is currently an Early Access program. To gain access, contact your Customer Success Manager.

CSQ Experience Platform guidance

Throughout the documentation, code samples highlight differences between standalone and CSQ Experience Platform integrations.

![CSQ Experience Platform docs support hint](https://docs.contentsquare.com/_astro/csqxp-docs-support-hint.1O6QoOlx_CO8z4.webp)

1. [Update the SDK package to 4.2.0 or later](../#install-the-sdk).

2. Replace your current `CSQ().start(startConfig: StartConfig.withEnvironmentId(...))` call with the `dataSourceId` provided by your Customer Success Manager. This links your app to the CSQ Experience Platform data source.

   ```dart
   await CSQ().start(startConfig: StartConfig.withDatasourceId(id: "YOUR_DATASOURCE_ID"));
   ```

   Find your data source ID

   `YOUR_DATASOURCE_ID` is either provided to you by Contentsquare or you can find it in **Definitions** > **Data sources** > \[Expand your mobile data source] > \[Copy the App ID in step 1] within the [CSQ Experience Platform web app ↗](https://app.contentsquare.com/).

3. Review changes [introduced in 4.2.0](#420---20260508) which notably removes support for several Product Analytics options.

## 4.4.1 - 2026.07.07

* **Bug fix:**

  * Fixed an error in interaction `autocapture` while keeping events captured correctly.
  * Improved interaction `autocapture` performance during scroll interactions.
  * Improved zoning and heatmap stability.

## 4.4.0 - 2026.06.30

* **Added:**

  * Swift Package Manager (SPM) support for iOS.

* **Improvements:**

  * Session Replay: improved capture of small, frequently-updating custom paint animations.
  * Extended Flutter version support to include 3.44.4.

## 4.3.1 - 2026.06.25

* **Bug fix:**

  * Fixed WebView tracking silently failing in apps with multiple Flutter engines.
  * Fixed WebView tracking not working on iOS scene-based apps.

## 4.3.0 - 2026.06.11

* **Bug fix:**

  * Fixed Long Snapshot for views containing WebViews on Android.

* **Native SDKs:**

  * Android: 1.10.1 → 1.11.0
  * iOS: 1.10.0 → 1.11.0

## 4.2.2 - 2026.06.05

* **Bug fix**
  * Repackage obfuscated Android classes to avoid R8 `a.*` collisions with other AARs.

## 4.2.1 - 2026.05.19

* **Bug fix**
  * Event tracking: event property serialization on iOS was fixed.

## 4.2.0 - 2026.05.08

Experience Analytics

The Session timeout definition changes from "30 minutes after being in background" to **30 minutes after last event**. See [Session definition](https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/data-collection/#session-definition).

Product Analytics

### Configuration

**Deprecated:** `CSQ().configureProductAnalytics()` still exists, but is now deprecated in favor of `CSQ().start()` which combines SDK configuration and initialization in a single call:

* Product Analytics

  **main.dart**

  ```dart
  await CSQ().configureProductAnalytics(
    environmentId: 'YOUR_ENVIRONMENT_ID',
  );
  await CSQ().start();


  await CSQ().start(
    startConfig: StartConfig.withEnvironmentId(
      id: 'YOUR_ENVIRONMENT_ID',
    ),
  );
  ```

* CSQ Experience Platform (Early Access)

  **main.dart**

  ```dart
  await CSQ().configureProductAnalytics(
    environmentId: 'YOUR_ENVIRONMENT_ID',
  );
  await CSQ().start();


  await CSQ().start(
    startConfig: StartConfig.withDatasourceId(
      id: 'YOUR_DATASOURCE_ID',
    ),
  );
  ```

### Options

**Added:** `AnalyticsOptions.sessionReplayAutoStart` — set to `false` to disable automatic Session Replay start and control it manually using `CSQ().startSessionReplay()` and `CSQ().stopSessionReplay()`. Defaults to `true`.

```dart
await CSQ().start(
  startConfig: StartConfig.withEnvironmentId(
    id: 'YOUR_ENVIRONMENT_ID',
    options: const AnalyticsOptions(sessionReplayAutoStart: false),
  ),
);
```

**Removed - Breaking:** `disableScreenviewForwardToDXA`, `disableScreenviewForwardToPA`, `resumePreviousSession`, `uploadInterval`, `captureVendorId`, `captureAdvertiserId`, `clearEventPropertiesOnNewUser`, `messageBatchMessageLimit`, `pruningLookBackWindow`, `maximumDatabaseSize`, and `maximumBatchCountPerUpload` options have been removed. Remove them from your `CSQ().start()` call if present:

```dart
await CSQ().start(
  startConfig: StartConfig.withEnvironmentId(
    id: 'YOUR_ENVIRONMENT_ID',
    options: const AnalyticsOptions(
      captureVendorId: true,
      captureAdvertiserId: true,
      clearEventPropertiesOnNewUser: true,
      messageBatchMessageLimit: 100,
      resumePreviousSession: true,
      pruningLookBackWindow: 6,
      maximumDatabaseSize: 10000000,
      maximumBatchCountPerUpload: 5,
      disableScreenviewForwardToDXA: true,
      disableScreenviewForwardToPA: true,
    ),
  ),
);
```

* **Native SDKs:**

  * Android: 1.5.0 → 1.10.1
  * iOS: 1.6.0 → 1.10.0

## 4.1.3 - 2026.04.27

* **Improvements:**
  * Session Replay fidelity was improved

## 4.1.2 - 2026.04.24

* **Improvements:**

  * Session Replay fidelity was improved
  * Multithread issues were fixed
  * Dialogs tracking was improved

## 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 Screenshot 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: 1.4.2 → 1.4.7

## 4.0.2 - 2026.01.29

* **Bug fix**

  * Session Replay: Fixed an issue that could cause `BackdropFilter` widgets to appear mispositioned in replays.
  * Interactions Autocapture: Improved performance when capturing interactions on complex widget trees.

## 4.0.1 - 2025.12.11

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

## 4.0.0 - 2025.12.05

Initial release of the CSQ SDK.

* Introduces the unified CSQ API, which combines `Product Analytics`, `Experience Analytics`, and `Monitoring` features into a single, cohesive library.