Customer.io
GitHub project

Upgrade from 4.x to 5.0.0

Version 5.0.0 of the Customer.io Flutter SDK uses version 5.0.0 of our native iOS and Android SDKs. It requires Flutter 3.44 or later, iOS 15 or later, and Android 7.0 (API level 24) or later.

What changed?

Version 5.0.0 of the Flutter SDK uses version 5.0.0 of the Customer.io iOS and Android SDKs. This raises the minimum versions your app needs:

  • Flutter 3.44 or later and Dart 3.12 or later: If your app uses an older version of Flutter, stay on version 4.x.
  • iOS 15 or later
  • Android 7.0 (API level 24) or later: The Android SDK also brings in firebase-messaging 26.0.0, play-services-base 18.11.1, and WorkManager (androidx.work) 2.12.0.

On iOS, the plugin now gets CioFirebaseWrapper from the customerio-ios package. It no longer uses the separate customerio-ios-fcm package.

You don’t need to change your Dart code or your AppDelegate.

Upgrade process

  1. Update the SDK version in your pubspec.yaml, and then run flutter pub get:

    YAML
    dependencies:
  customer_io: ^5.0.0

  2. Raise your iOS deployment target to 15.0. In Xcode, set it for your Runner target and your NotificationServiceExtension target. If you use CocoaPods, update the platform in ios/Podfile too:

    RUBY
    platform :ios, '15.0'

  3. In your android/app/build.gradle file, set minSdk to 24 or higher. Make sure your app builds with compileSdk 36 or later and Android Gradle plugin (AGP) 8.9.1 or later.

  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. Update your iOS dependencies:

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

    BASH
    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 4.x. Your Podfile.lock still lists the 4.x pods, so a plain pod install stops with an error, and pod repo update doesn’t fix it.

    Flutter resolves version 5.0.0 of customerio-ios for you. If you added the customerio-ios-fcm package to your Xcode project, remove it. In Xcode, select your project, go to Package Dependencies, select customerio-ios-fcm, and click -.
Updated October 26, 2026