NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1450 most downloaded on pub.dev
An official flutter plugin for Customer.io, an automated messaging platform for tech-savvy marketers.
Latest stable
5.1.1
Last release 23 days ago
30 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
88 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
In-app (iOS and Android): Updates the bundled native SDKs from iOS 5.1.0 to 5.1.3 and Android 5.0.0 to 5.0.3. Switching users without calling clearIde
Flutter 5.1.1
clearIdentify now resets in-app state and reconnects as the new user, and overlapping message fetches for the same user share one request. (#440) (295f17c)identify now arrive without backgrounding the app. When live updates are not in use, messages are fetched as soon as the app returns to the foreground. Modal content stays visible when the keyboard opens. (#440) (295f17c)identify() no longer call the Android Keystore on the calling thread, which could cause an ANR at launch on slow devices. (#440) (295f17c)Your coding agent can read these notes before it upgrades. Set up the MCP server →
MBL-2652: make InAppConfig.siteId optional with a pk_ key
take native iOS and Android 5.0, migrate the Android plugin to built-in Kotlin, and require Flutter 3.44
minSdk to 24, which native iOS and Android 5.0 require.CioFirebaseWrapper now comes from customerio-ios, so the separate customerio-ios-fcm package is no longer used. With SwiftPM, remove customerio-ios-fcm from your Xcode project if you added it there.CustomerIOLiveActivitiesTemplates and CustomerIOLiveActivitiesAttributes pods to 5.0.0 in ios/Podfile.pod update CustomerIO in ios/ once (FCM apps: pod update CustomerIO CioFirebaseWrapper). A plain pod install stops on the 4.x versions in Podfile.lock, and pod repo update doesn't help.firebase-messaging 26, play-services-base 18.11 and WorkManager 2.12. If your app pins older versions of these, update them.Geofencing: Adds dwell events. Set a dwell time on a geofence in Customer.io, and the SDK sends a dwell transition once a person has stayed inside tha
dwell transition once a person has stayed inside that long, so you can reach people who actually visit instead of everyone passing by. (#429) (0981854)visitDurationSeconds), so you can trigger automations like "left after more than 20 minutes inside". (#429) (0981854)Public API keys. This release changes how the SDK handles API keys. You can now start the SDK with the new public pk_ key, and it reads your region (U
pk_ key, and it reads your region (US or EU) from that key. Secret sk_ keys are refused, because secret keys must never ship inside an app. To upgrade, create a public pk_ key in Customer.io and pass it as your API key. In-app messaging still needs your siteId. This release updates the native SDKs to iOS 4.12.0 and Android 4.25.0. (#416) (8243156)FCM apps can now register Firebase Installation IDs instead of FCM tokens. It's opt-in, and apps that don't opt in keep using FCM tokens. APNs apps ar
android: include native rich push image memory fixes
messagingpush: handle Flutter rich push off main thread (MBL-2548)
Polygon Geofences: Geofences drawn as polygons in Customer.io are now supported, so enter and exit events follow the exact shape of a venue. This appl
Polygon Geofences: Geofences drawn as polygons in Customer.io are now supported, so enter and exit events follow the exact shape of a venue. This applies to apps using the geofence module. Circle geofences behave exactly as before, no code changes are needed, and geofences cached by earlier versions keep working after the upgrade.
in-app: allow overriding the in-app message color scheme
inbox: let apps configure visual inbox accessibility labels
route SDK deep links through Flutter scenes
restore Flutter package publishing
update native SDKs — iOS 4.7.2 (geofence enter/exit reliability and in-app page route rule matching) and Android 4.20.1 (geofence enter/exit event acc
## 4.1.3 (2026-07-24)
update native SDKs — iOS 4.5.3 (resolve duplicate event delivery bugs) and Android 4.18.2 (scope in-app polling to process lifecycle)
release native SDK update (iOS 4.5.1, Android 4.18.1)
4.18.1 — Harden push notification activity and in-app message WebView (release notes)4.5.1 — Internal test-isolation refactor; no runtime impact (release notes)update native SDKs to iOS 4.5.0 and Android 4.18.0
update Customer.io native SDKs (iOS 4.4.3, Android 4.17.1)
Fix in-app messages not displaying when app returns from background when SSE enabled
Added support for Swift Package Manager (SPM) in Flutter SDK. No changes for apps using CocoaPods, apps using SPM should refer to the updated document
Push delivery reslience improvement
## 3.4.0 (2026-03-11) ### Features * Location enrichment
Added support for Notification Inbox
Downgrade okhttp version to 4.x
Remove outdated sonatype snapshot dependency
In-app messages now support SSE (Server-Sent Events) as an alternative to polling, reducing latency and improving message delivery efficiency
Bump Android compileSdk to 36 for AndroidX compatibility
Updated the SDK and dependencies for Android 16 compatibility, including minor updates to better support newer OS restrictions and behavior changes.
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.prevent message type crash in release builds
Add CioFirebaseWrapper to pull in Firebase specific services
You can now send banners, modals, pop-ups, and surveys to anonymous visitors —no ID or email required.
Improve push notificaiton delivery receipts delay
but this also means apps needs to have the following minimum requirement
but this also means apps needs to have the following minimum requirement
Upgrade Android compileSdk to 34
Updated Native iOS SDK from 3.11.0 to 3.13.1 which includes following updates:
3.11.0 to 3.13.1 which includes following updates: (#280) (70c78cc)
CioAppDelegateWrapperAlign public API with other CIO SDK platforms
Fixed an issue where inline message view occupied 1dp of space even when no content was available. With this fix, the view no longer takes up any visu
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 tool
Fixed build issue on iOS by adding a default implementation for an internal SPI method in DeepLinkUtil, preventing conformance errors with BUILD_LIBRA
Add ability to configure messaging channels for local notifications
Preserve numeric types when doing sanitization for JSON
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
Add support for iOS no-swizzling approach and improve example app setup
Fixed a crash that occurred only when the app was restored by Android OS from background after being removed from memory with a modal in-app message a
Fixed an issue where SDK calls returning no result (i.e. void) were incorrectly logged as errors for unsupported values. The fix removes unnecessary e
Updates the iOS native dependency from 3.8.1 to 3.8.2 and Android native dependency from 4.5.6 to 4.5.8 which includes the following improvements.
Updates the iOS native dependency from 3.8.1 to 3.8.2 and Android native dependency from 4.5.6 to 4.5.8 which includes the following improvements.(#221) (56418f2)
Better support for user data with missing fields—SDK now handles null values in nested attributes or traits gracefully.
Updates the iOS native dependency from 3.8.0 to 3.8.1 and Android native dependency from 4.5.3 to 4.5.5 which includes the following improvements.
Updates the iOS native dependency from 3.8.0 to 3.8.1 and Android native dependency from 4.5.3 to 4.5.5 which includes the following improvements.
Incorrectly scrolling content for in-app modal messages positioned top/bottom
Android 14 introduced strict rules for when apps are in the killed state, impacting push delivery tracking. This release fixes that.
Updates the iOS native dependency from 3.7.1 to 3.7.2 and Android native dependency from 4.5.0 to 4.5.2 which includes the following improvements.
Updates the iOS native dependency from 3.7.1 to 3.7.2 and Android native dependency from 4.5.0 to 4.5.2 which includes the following improvements.
Added ability to disable forwarding screen events to destinations/servers. Apps can still send screen events for local processing and use them for pag
Data Pipelines Support: Sending your mobile data into our customer data platform (CDP) helps you support Journeys and the rest of your martech stack—a
NOTE: Please follow the migration guide for a seamless upgrade to this version.
Updates Android Native dependency from 3.11.0 to 3.11.2 which includes following improvements.
Updates Android Native dependency from 3.11.0 to 3.11.2 which includes following improvements.
CustomerIO.MessagingInApp().dismissMessage() explicitly would print crash logs on Android. The method can now be called safely without unnecessary logs. [#142] (1635acf)Resolved an issue where the native iOS code communicated to the Flutter code on a non-platform thread. This change ensures that platform channel messa
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 ma
support for android gradle plugin 8
added proguard rules for R8 strict mode
One column per quarter.