---
title: Changelog - Flutter
description: The Contentsquare Flutter SDK changelog
lastUpdated: 11 March 2026
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-flutter/product-analytics/changelog/
  md: https://docs.contentsquare.com/en/csq-sdk-flutter/product-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)

Faster implementation using agent skills

Use [Agent skills](https://docs.contentsquare.com/en/csq-sdk-flutter/product-analytics/using-agent-skills/) to let your AI coding assistant handle SDK setup, version migration, and feature implementation automatically.

1. [Update the SDK package to 4.2.0](../#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.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:

* Standalone

  **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

  **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.