Upgrade Live Chat SDK on React Native
Updated
Upgrade to the latest version of the Live Chat SDK to take advantage of new features, enhancements, and performance improvements that enhance your app's user experience. For a detailed list of updates in this release, refer to the release notes.
Current Release
Live Chat SDK Current Release: 14.0.1
Breaking Change for Upcoming Release:
Minimum Supported React Native Version
Starting with April 2026 (upcoming release):
The minimum supported React Native (RN) version will be React Native v0.80.
This update aligns with React Native’s official deprecation of versions 0.79 and below.
Action Required
Update your projects to React Native v0.80 or higher before the April release to maintain compatibility and prevent disruption.
Upgrade to 14.0.1
To upgrade to 14.0.1, follow these steps:
Breaking Change: You must install the react-native-reanimated dependency, as it is required for this release. For more information, see Additional React Native Features. To install, see Install Peer Dependencies.
Installation & Setup
Upgrade React Native: Ensure your project is using React Native version ≥0.73.0 up to ≤0.82.0.
Upgrade to Yarn 3 and Node 22: We have upgraded the SDK repo to Yarn 3 and Node 22. For instructions, see Configure Sprinklr Messenger Registry.
Install Live Chat SDK 14.0.1: Add the Sprinklr Live Chat Messenger using version 14.0.1. For more information, see Install Sprinklr Messenger.
Configure Sprinklr Messenger Registry: Set up the appropriate registry and authentication using npm or yarn. (See Configure Sprinklr Messenger Registry.)
Set Up Live Chat Messenger: During setup, remove the resolutions field from your package.json file. The resolutions field is no longer required.
Video Calling Support
Update AWS Chime: Upgrade to version 2.0.1
Enable Video Call Continuity Outside Live Chat: This feature allows users to continue an ongoing video or audio call in audio‑only format, even after navigating away from the Live Chat SDK.
For more information, see Set Up Video Calling for React Native.
Co-browsing Support
Update cobrowse-sdk-react-native Dependency (Supported version 3.0.0 or later)
Enable Co-browse Features: Add support for Screen Sharing and Redaction.
For more information, see Enable Co-Browsing.
Upgrade to 13.0.2
NOTE: Breaking Changes:
Expiry Support for Authentication Hash: Starting with this release, authentication hash will be generated with a defined expiration period. This enhances security by ensuring that each hash remains valid only for a limited time. For implementation details, see How to Generate User Hash.
To upgrade to 13.0.1, take a note of the following:
Upgraded React Native Version: React Native Version Upgraded to 0.80.1.
Install Live Chat SDK 13.0.2: Install the Sprinklr Live Chat Messenger using version 13.0.2. For detailed steps, see Install Sprinklr Messenger.
Dependency for Typing Indicator: If you want to support typing indicator in Live Chat, install the @react-native-masked-view/masked-view dependency.
For more information, see the row for @react-native-masked-view/masked-view dependency in the Additional React Native Features table.
Migration from AsyncStorage to React Native Keychain for Enhanced Security: Starting from version 13.0.0, Sprinklr Messenger has transitioned from using AsyncStorage to react-native-keychain. For anonymous users, the chat session token is stored locally on the device. To ensure backward compatibility and a smooth migration, we recommend including both dependencies for the next year.
For more information, see the row for react-native-keychain dependency in the Additional React Native Features table.
Support added for Video Calling in React Native: If you want to use video calling in live chat in React Native please refer to Set Up Video Calling in React Native section.
Upgrade to 12.1.2
Install Live Chat SDK 12.1.2: Install the Sprinklr Live Chat Messenger using version 12.1.2. For detailed steps, see Install Sprinklr Messenger.
Upgrade to 12.0.0
Install Live Chat SDK 12.0.0: Install the Sprinklr Live Chat Messenger using version 12.0.0. For detailed steps, see Install Sprinklr Messenger.
Upgrade React Native and React: This release supports React Native upto 0.78.2 versions. You can upgrade to the 0.78.2 based on your requirements. For more information, see React Native UI Components.
Note: If you are upgrading to React Native version 0.78.2, you also need to upgrade React to version 19.0.0