---
title: Changelog - React Native
description: The Contentsquare React Native SDK changelog
lastUpdated: 04 May 2026
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-react-native/product-analytics/changelog/
  md: https://docs.contentsquare.com/en/csq-sdk-react-native/product-analytics/changelog/index.md
---

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

## CSQ SDK

## 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 version 6.3.0 or later](../#install-the-sdk).

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

   **App.js**

   ```javascript
   CSQ.start(StartConfig.withDataSourceId("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 6.3.0](#630---20260512) which notably removes support for several Product Analytics options.

### 6.4.0 - 2026.06.12

* **Native SDKs:**

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

Experience Analytics

* **Session Replay**

  * Added new APIs to support Event-Triggered Replays (ETR)

* **WebViews Bug fix**

  * Android: Fixed an issue when navigating back within WebViews

### 6.3.0 - 2026.05.12

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-react-native/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

  **App.js**

  ```javascript
  CSQ.configureProductAnalytics("YOUR_ENVIRONMENT_ID", {
    enableRNAutocapture: true,
  });
  CSQ.start();


  CSQ.start(StartConfig.withEnvironmentId("YOUR_ENVIRONMENT_ID", {
    enableRNAutocapture: true,
  }));
  ```

* CSQ Experience Platform

  **App.js**

  ```javascript
  CSQ.configureProductAnalytics("YOUR_ENVIRONMENT_ID", {
    enableRNAutocapture: true,
  });
  CSQ.start();


  CSQ.start(StartConfig.withDataSourceId("YOUR_DATASOURCE_ID", {
    enableRNAutocapture: true,
  }));
  ```

### 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`.

```javascript
CSQ.start(StartConfig.withEnvironmentId("YOUR_ENVIRONMENT_ID", {
  sessionReplayAutoStart: false,
}));
```

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

```javascript
CSQ.start(StartConfig.withEnvironmentId("YOUR_ENVIRONMENT_ID", {
  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.1 → 1.10.1
  * iOS: 1.6.3 → 1.10.0

* **Bug fix**
  * iOS: Fixed an issue where number event properties will be parsed as boolean values in some cases

### 6.2.0 - 2026.04.22

@contentsquare/react-native-cli

**v1.0.0** is now available. See [the dedicated changelog](#contentsquarereact-native-cli).

* **Native SDKs:**

  * Android: 1.5.0 → 1.5.1
  * iOS: 1.6.0 → 1.6.3

* **Bug fix**
  * Fixed a duplicate `hasListener` symbol conflict with third-party libraries

* **WebViews**
  * Removed unnecessary super calls in bridge handlers

* Removed the upper version limit for the React Native peer dependency. The CSQ SDK has been validated up to React Native version 0.85.

### 6.1.0 - 2026.02.26

* **Native SDKs:**

  * Android: 1.4.7 → 1.5.0
  * iOS: 1.5.1 → 1.6.0

* **Bug fix**

  * Fixed iOS module headers to ensure compatibility with CocoaPods projects using `use_frameworks! :linkage => :static`
  * Fixed 0.82.x Session Replay compatibility issues

* Official support for React Native up to 0.84.x

Warning

* Android: React Native crashes are not deobfuscated in Error Analysis. We are currently investigating this issue.

### 6.0.5 - 2026.02.11

* **Native SDKs:**

  * Android: 1.4.2 → 1.4.7

* **Bug fix**

  * Fixed a crash in Android WindowCallbackWrapper

### 6.0.3 - 2026.02.03

* **Bug fix**
  * WebViews: Fixed an issue with the `userAgent` prop being overwritten

### 6.0.2 - 2025.12.15

Contentsquare CLI

* **v0.1.4** is now available. Update to this version if your app uses React Native 0.82 or above. See [Error Analysis](https://docs.contentsquare.com/en/csq-sdk-react-native/experience-analytics/error-analysis/#source-maps) for more information.

Session Replay

* **iOS React Native 0.82.x** is not fully compatible with Session Replay feature.

- **Bug fix**
  * Changed the default value of `disableInteractionAutocapture` to `false` to re-enable interaction capture by default
- Fixed an issue with pod installation failing on React Native versions below 0.80
- Official support for React Native up to 0.82.x

### 6.0.1 - 2025.12.05

Contentsquare CLI

* **v0.1.3** is now available for version 6.0.1 and above. See [Error Analysis](https://docs.contentsquare.com/en/csq-sdk-react-native/experience-analytics/error-analysis/#source-maps) for more information.

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.

***

## `@contentsquare/react-native-cli`

See [CLI configuration](https://docs.contentsquare.com/en/csq-sdk-react-native/experience-analytics/error-analysis/#cli-configuration) for configuration details.

### 1.0.0 - 2026.04.21

**Breaking Change:** The CLI package name has changed from `@contentsquare/cli` to [`@contentsquare/react-native-cli` ↗](https://www.npmjs.com/package/@contentsquare/react-native-cli). If you already have the CLI installed:

1. Update the package name in your `package.json`:

   ```jsx
   "devDependencies": {
     "@contentsquare/cli": "<file_path_to_the_downloaded_.tgz_package>",
     "@contentsquare/react-native-cli": "1.0.0",
   }
   ```

2. Update the paths in your [source maps](https://docs.contentsquare.com/en/csq-sdk-react-native/experience-analytics/error-analysis/#source-maps) upload configuration:

   * Android

     **android/app/build.gradle**

     ```groovy
     apply from: "../../node_modules/@contentsquare/cli/scripts/contentsquare.gradle"
     apply from: "../../node_modules/@contentsquare/react-native-cli/scripts/contentsquare.gradle"
     ```

   * iOS

     **Bundle React Native code and images**

     ```shell
     CONTENTSQUARE_XCODE="$SRCROOT/../node_modules/@contentsquare/cli/scripts/contentsquare-xcode.sh"
     CONTENTSQUARE_XCODE="$SRCROOT/../node_modules/@contentsquare/react-native-cli/scripts/contentsquare-xcode.sh"
     ```

* Fix support for Gradle 9+