Changelog

Check out release history our React Native SDK. Stable releases have been tested thoroughly and are ready for use in your production apps.

Need to upgrade?

Select your current version to see all the features and fixes from your version to the latest release.

5.x Releases

    • 5.1.0

      code changes

      Features

      • Updated the SDK and dependencies for Android 16 compatibility, including minor updates to better support newer OS restrictions and behavior changes. (#533) (fd567f3)

      ⚠️ Notes

      • Apps now may need to update their compileSdk version to 36 and Gradle version to at least 8.9.3 to ensure compatibility with updated dependencies and to successfully build against Android 16.

    • 5.0.1

      code changes

      Bug Fixes

      • prevent message type crash in release builds (#531) (587012b)

    • 5.0.0

      code changes

      ⚠ BREAKING CHANGES

      • Add CioFirebaseWrapper to pull in Firebase specific services (#528)

      Features

      • Add CioFirebaseWrapper to pull in Firebase specific services (#528) (3c11e2e)

4.x Releases

    • 4.11.0

      code changes

      Features

      • You can now send banners, modals, pop-ups, and surveys to anonymous visitors —no ID or email required. (#526) (f114d29)

    • 4.9.0

      code changes

      Breaking Features

      • Support for Kotlin 2+ is added (#591) (b5f94ff)

      but this also means apps needs to have the following minimum requirement

      • Gradle: 8.0 or later
      • Android Gradle Plugin (AGP): 8.0 or later (8.2+ recommended)
      • Kotlin: 1.9.20 or later (2.0+ required if using Kotlin Multiplatform or K2-specific features)

      Features

      • Upgrade Kotlin and AGP versions (#284) (ed9da81)
      • Added support for queue sticky sessions from latest Android native SDK (customerio/customerio-android#598)
      • Align public API with other CIO SDK platforms from latest Android native SDK (customerio/customerio-android#600)

      Bug Fixes

      • Resolved a crash when dismissing in app messages using back press during initial loading phase. Users can now safely navigate away from messages without encountering unexpected app crashes. from latest Android native SDK (customerio/customerio-android#608)
      • Fix in-app inline tabbed bug (#521)

    • 4.8.3

      code changes

      Bug Fixes

      • Disabled native logging on armeabi devices using new architecture to prevent rare crashes from low level C++ code, no functional impact to end users. (#516) (c406795)

    • 4.8.2

      code changes

      Improvements

      • Ensures in-app message event listener is set during module initialization to better support Expo auto initialization and avoid direct React imports that could lead to runtime issues. Behavior remains unchanged for manually initialized setups. (#513) (ad4b169)

    • 4.8.1

      code changes

      Bug Fixes

      • Add missing InApp dismissMessage() for legacy RN architecture (#511) (6ab19f5)

    • 4.8.0

      code changes

      Improvements

      • Updated Native iOS SDK from 3.11.0 to 3.13.1 which includes following updates: (#507) (e5821d3)
        • Added support for queue sticky sessions
        • Align public API with other CIO SDK platforms
        • Fixed build issues on Xcode 26 beta that only affected apps using CocoaPods
        • Fixed an issue where custom scheme URLs were not opening when using FCM with CioAppDelegateWrapper

    • 4.7.0

      code changes

      Features

      • Improved logger listener setup to improve performance and reliability on low-end devices (#493) (e6d37e4)
      • Added support for optional automatic SDK initialization with Expo plugin, reducing setup complexity (#504) (d3ed7f9)

    • 4.6.0

      code changes

      ⚙️ Utilizing React Native New Architecture

      • This release fully adopts React Native’s new architecture using Fabric and TurboModules while maintaining compatibility with old architecture. No changes to public API, apps will automatically use appropriate setup based on their configuration. (#484) (2476ee9)

    • 4.5.2

      code changes

      Fixes and Tooling update

      • Support for FCM 12.x is added which requires a minimum iOS deployment target of 15. If you’re using FCM module, ensure your deployment target and tooling are up to date. Or lock Firebase to 11.x to avoid compatibility issues
      • Fixes a crash when build attributes from device are nullable (iOS 3.11.0, Android 4.7.1) (#471) (f8b78eb)

    • 4.5.1

      code changes

      Bug Fixes

      • Fixed build issue on iOS by adding a default implementation for an internal SPI method in DeepLinkUtil, preventing conformance errors with BUILD_LIBRARY_FOR_DISTRIBUTION = YES (#466) (ccc149c)

    • 4.5.0

      code changes

      Features

      • Add ability to configure messaging channels for local notifications (#462) (2ddf8f5)

    • 4.4.3

      code changes

      Bug Fixes

      • Preserve numeric types when doing sanitization for JSON (#460) (b1e5080)

    • 4.4.2

      code changes

      Bug Fixes

    • 4.4.1

      code changes

      Bug Fixes

      • Fixed a bug where apps using older versions of React Native with new architecture could fail to locate native inline wrapper component, causing integration issues on iOS (#454) (557aa0e)

    • 4.4.0

      code changes

      Features

      • Added support for inline in-app messages. Inline in-app messages act like a part of the content on your page. They let you dynamically populate parts of your app and talk to your customers without interrupting their experience. (#453) (d11041b)

    • 4.3.1

      code changes

      Bug Fixes

      • Fixed an issue where the SDK enforced a strict version of firebase messaging, preventing integration with newer versions.
      • Fixes the bug where multi screen in-app messages might dismiss earlier than intended (#437) (e513bfb)

    • 4.3.0

      code changes

      Features

      • Includes new system for accessing device-token and tracking notifications events. This replaces old Swizzling-based system, in iOS SDK. The change increases stability and improves compatibility with other SDKs (like Firebase) (#434) (f864e89)

    • 4.1.1

      code changes

      Bug Fixes

      • Resolved compatibility issues with React Native 0.76 on iOS apps (#359) (6fcdd91)

    • 4.1.0

      code changes

      Updates the iOS Native dependency from 3.5.1 to 3.6.0 which includes the following improvements.

      Features

      • This release introduces support for displaying larger in-app messages. (#356) (72bda17)

      Fixes

      Improvement

      • Updated our SDK to use the v2 version of our in-app messages API. This will provide a more reliable experience for in-app messages. (#834) (#461)

    • 4.0.2

      code changes

      Updates the iOS Native dependency from 3.5.0 to 3.5.1 which includes the following improvements.

      Bug Fixes

      • Dismisses the keyboard when an in-app message appears on the screen, ensuring uninterrupted user interaction (#350) (74b2379)

    • 4.0.1

      code changes

      Improvement

      • Updated the workflow to automatically update the Android native SDK version in the package, ensuring greater consistency and reducing manual intervention during updates. (b477fbc)

    • 4.0.0

      code changes

      ⚠ BREAKING CHANGES

      • Data Pipelines Support: Sending your mobile data into our customer data platform (CDP) helps you support Journeys and the rest of your martech stack—analytics, data warehouses, CRMs, and more. (#349)

      NOTE: Please follow the migration guide for a seamless upgrade to this version.

      Features

      • Anonymous tracking: You can send anonymous events, and we’ll reconcile anonymous activity with your users when you identify them. (#349) (6665c9f)
      • Built-in lifecycle events: the SDK now automatically captures events like “Application Installed” and “Application Updated” for you, so you better understand your users’ behaviors in your app.
      • New device data: The SDK captures complete device-level context, such as your audience’s screen dimensions, device names, and more.

3.x Releases

    • 3.9.1

      code changes

      Features

      • Adds support for the latest versions of the Firebase dependency (>11) (#344) (11d17e1)

    • 3.9.0

      code changes

      Updates the iOS Native dependency from 2.13.2 to 2.14.1 which includes the following improvements.

      Features

      • Reduced the time for first in-app message to be shown for newly identified profiles. For new profiles, in-app messages are now fetched as soon as the profile is identified.(#307) (cb272c2)

      Bug Fixes

      • Explicitly switched threads to avoid forcing identify calls to be made on main thread. The SDK now automatically switches to appropriate thread, regardless of the thread used to make identify calls.

    • 3.8.0

      code changes

      Features

      • When using page rules and when an in-app messages need a second to load, the in-app message might appear after a user navigates to another page. We made changes to ensure the page-rules are checked after the message is loaded and immediately before it’s displayed in order to resolve this issue. (#285) (478f644)

    • 3.7.2

      code changes

      Bug Fixes

      • This release addresses a compatibility issue for apps that have installed two or more third-party SDKs (besides Customer.io SDK) that handle push notifications. While this issue was primarily reported by our Flutter customers, it could also affect native iOS and React Native applications. (#283) (84d7259)

    • 3.7.1

      code changes

      Bug Fixes

      • References the 2.13.1 version of the iOS SDK. This resolves a compatibility issue with 3rd party FCM Flutter and React Native SDKs. In some cases, the issue prevented push notifications from showing while the app was in the foreground when the 3rd party SDK and CIO SDK were both installed. (#273) (456da1e)

    • 3.7.0

      code changes

      Features

      Note:

      • Android Gradle plugin version 7.4 or later is required.
      • JDK 17 is also required for Gradle 8.

    • 3.5.4

      code changes

      Bug Fixes

      • added proguard rules for R8 strict mode (#253) (6686206)

    • 3.5.3

      code changes

      Bug Fixes

      • do not bundle .md files in cocoapods deployments (a815336)

    • 3.5.2

      code changes

      Bug Fixes

      • expo users reported app crash on didFailToRegisterForRemoteNotificationsWithError (#244) (fb9a464)

    • 3.5.1

      code changes

      Bug Fixes

      • edge case for image download in rich push (#242) (04b63f8)

    • 3.5.0

      code changes

      Features

      • new header for polling interval and enable ios logging for in-app (#237) (f77ff0e)

    • 3.4.0

      code changes

      Features

      • increase opened metrics reliability and 3rd party push SDK compatibility (#236) (514b719)

    • 3.0.0

      code changes

      Installing and updating our React Native SDK got easier. Follow our migration docs (it only requires modifications to your Podfile) to use version 3 our React Native SDK!

      ⚠ BREAKING CHANGES

      • auto-update native SDK and easier rich push install (#149)

      Bug Fixes

      • auto-update native SDK and easier rich push install (#149) (7e56d1e)

2.x Releases

1.x Releases

    • 1.0.0

      code changes

      Features

      • android updates in package (#13) (b708fce)
      • android: package updates (e87c6eb)
      • android: setup config with initialization (e915343)
      • creating customerio react native package (#1) (2d2bdae)
      • device attributes and other configurable properties (#4) (bd79d96)
      • identify and clear user identity (#2) (4430b66)
      • in-app functionality in react native package (488c0c0)
      • update package version (8526a69)
      • updated to android sdk 3.0.0-alpha.2 (91978d7)
      • updating ios sdk version in podspec (1b1c26f)
      • user-agent updates in package (efff4fc)

      Bug Fixes

      • added support for android sdk 3.1.0 (44a1b91)
      • change in way to update config in ios (#15) (8680b28)
      • initialized sdk from storage using context (e3e609a)
      • push notifications integration (#10) (5d7752d)
      • updating gist dependency version (9f8ac3f)

      Reverts