> This page is part of the [Customer.io documentation](https://docs.customer.io). For the complete index, see [llms.txt](https://docs.customer.io/llms.txt).
> Last updated: October 27, 2026
> To take actions in Customer.io from an agent, use the [Customer.io CLI](https://docs.customer.io/ai/cli/get-started.md) or the [MCP server](https://docs.customer.io/ai/mcp/get-started.md).

# Upgrade from 6.x to 7.0.0

Version 7.0.0 of the Customer.io React Native SDK uses version 5.0.0 of our native iOS and Android SDKs. You don't need to change your code, but you need to update your iOS pods once.

## What changed?

Version 7.0.0 of the React Native SDK uses version 5.0.0 of the Customer.io iOS and Android SDKs. You don’t need to change your JavaScript code or your `AppDelegate`. Your `Podfile` stays the same, unless you set up live notifications.

*   **iOS 15 and Android 7.0 (API level 24)**: The native SDKs now require these versions. Every version of React Native that the SDK supports already requires iOS 15.1 and API level 24, so you don’t need to change your deployment target or `minSdkVersion`. The SDK’s Android module now defaults to a `minSdkVersion` of 24.
*   **`CioFirebaseWrapper` comes from `customerio-ios`**: If you send push notifications through Firebase Cloud Messaging (FCM), the `customerio-reactnative/fcm` pod now installs `CioFirebaseWrapper` from the `customerio-ios` package, at the same version as the rest of the iOS SDK. It no longer uses the separate `customerio-ios-fcm` package. The pod still installs `FirebaseMessaging` for you.
*   **Newer Android libraries**: The Android SDK now brings in `firebase-messaging` 26.0.0, `play-services-base` 18.11.1, and WorkManager (`androidx.work`) 2.12.0.
*   **Android build**: Your app needs `compileSdk` 36 or later and Android Gradle plugin 8.9.1 or later. This requirement isn’t new in 7.0.0, but apps on React Native 0.77 to 0.80 might need to raise these versions. See [Minimum requirements](https://docs.customer.io/integrations/sdk/react-native/getting-started/how-it-works/#minimum-requirements).

## Upgrade process

1.  Update the SDK:

    ```
    npm install customerio-reactnative@7
    # or
    yarn add customerio-reactnative@7
    ```

2.  If you set up [live notifications](https://docs.customer.io/integrations/sdk/react-native/live-notifications/set-up/), change the `CustomerIOLiveActivitiesTemplates` and `CustomerIOLiveActivitiesAttributes` versions in your widget extension’s Podfile target to `5.0.0`.

3.  Update the Customer.io pods. If you use FCM, run:

    ```
    cd ios
    pod update CustomerIO CioFirebaseWrapper
    ```

    If you use APNs, run `pod update CustomerIO` from your `ios` folder instead.

    You only need to do this once, when you upgrade from 6.x. Your `Podfile.lock` still lists the 6.x pods, so a plain `pod install` stops with an error, and `pod repo update` doesn’t fix it.

4.  If your Android app pins older versions of `firebase-messaging`, `play-services-base`, or WorkManager, update them to at least 26.0.0, 18.11.1, and 2.12.0.

5.  Rebuild your app.

## Known limitation

React Native Firebase 27 includes Firebase only through Swift Package Manager, so you can’t use it with `customerio-reactnative/fcm` yet. Version 6.x has the same limitation.