NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #3450 most downloaded on pub.dev
Batch SDK Flutter Plugin allows you to build meaningful communication experiences in your app through highly personalized push notifications and In-App messages.
Last release 5 months ago
22 Apr 2026
Release timing varies
gaps range from 3 weeks to 1.4 years
Nearly every release is documented
notes for 12 of 12 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
14 releases · first in 2021
One column per quarter.
Added setTopicPreferences(List ? topics) to BatchProfileAttributeEditor class to set or reset the profile topic preferences.
Plugin
Profile
setTopicPreferences(List<String>? topics) to BatchProfileAttributeEditor class to set or reset the profile topic preferences.addToTopicPreferences(List<String> topics) to BatchProfileAttributeEditor class to add topics to the profile topic preferences.removeFromTopicPreferences(List<String> topics) to BatchProfileAttributeEditor class to remove topics from the profile topic preferences.BatchProfileAttributeEditor.setStringAttribute() longer than 64 characters will only be applied to the CEP.BatchEventAttributes.putString() longer than 200 characters will only be applied to the CEP.Push
requestNotificationAuthorizationAsync()to request notification authorization and return a promise that resolve with the authorization result.Batch requires iOS 15.0 or higher and Xcode 16.4
Plugin
Push
setShowNotifications method to control whether android push notifications should be displayed.shouldShowNotifications method to check current android notification display settings.Messaging
Batch requires iOS 13.0 or higher.
Plugin
iOS
Profile
setPhoneNumber API to the BatchProfileAttributeEditor class. This requires to have a user identifier registered or to call the identify method beforehand.setSMSMarketingSubscription API to the BatchProfileAttributeEditor class.Removed deprecated canUseIDFA property from BatchPluginConfiguration.
This is a major release, please see our migration guide for more info on how to update your current Batch implementation.
Plugin
minSdk level of 21 or higher.iOS
canUseIDFA property from BatchPluginConfiguration.canUseAdvancedDeviceInformationproperty from BatchPluginConfiguration. You should now use the setAutomaticDataCollection API.profileCustomIdMigrationEnabled property to disable the profile custom id migration. This can also be done from the Info.plist file. See our documentation for info.profileCustomDataMigrationEnabled property to disable the profile custom data migration. This can also be done from the Info.plist file. See our documentation for info.Android
canUseAdvertisingID method from BatchPluginConfiguration.setCanUseAdvancedDeviceInformation and canUseAdvancedDeviceInformation method from BatchPluginConfiguration. You should now use the new setAutomaticDataCollection API.setProfileCustomIdMigrationEnabled method to disable the profile custom id migration. This can also be done from the AndroidManifest meta-data. See our documentation for info.setProfileCustomDataMigrationEnabled method to disable the profile custom data migration. This can also be done from the AndroidManifest meta-data. See our documentation for info.Core
isOptedOut to checks whether Batch has been opted out from or not.setAutomaticDataCollection to fine-tune the data you authorize to be tracked by Batch.User
trackTransaction with no equivalent.BatchUser.newEditor and the related class BatchUserDataEditor, you should now use BatchProfile.instance.newEditor() which return an instance of BatchProfileAttributeEditor.clearInstallationData which allows you to remove the installation data without modifying the current profile.Event
This version introduced two new types of attribute that can be attached to an event : Array and Object.
trackEvent APIs from the user module. You should now use BatchProfile.instance.trackEvent.BatchEventData has been renamed into BatchEventAttributes.putObject method to BatchEventAttributes.putObjectList method BatchEventAttributes.putStringList method BatchEventAttributes.addTag API from BatchEventData You should now use the $tags key in BatchEventAttributes with the putStringList method.label from trackEvent API. You should now use the $label key in BatchEventAttributes with the putString method.Profile
Introduced BatchProfile, a new module that enables interacting with profiles. Its functionality replaces most of BatchUser used to do.
identify API as replacement of BatchUser.instance.newEditor().setIdentifier.newEditor method to get a new instance of a BatchProfileAttributeEditor as replacement of BatchUserDataEditor.trackEvent API as replacement of the BatchUser.instance.trackEvent methods.trackLocation API as replacement of the BatchUser.instance.trackLocation method.Android's Methods setCanUseAdvertisingID and canUseAdvertisingID from BatchPluginConfiguration are now deprecated and do nothing.
Plugin
User
setCanUseAdvertisingID and canUseAdvertisingID from BatchPluginConfiguration are now deprecated and do nothing.com.batch.flutter.use_gaid has been removed.canUseIDFA from BatchPluginConfiguration is now deprecated and does nothing.BatchFlutterCanUseIDFA has been removed.setAttributionIdentifier(String? id) method. Batch will persist it across starts.setEmail(String? email) method to BatchUserDataEditor. This requires to have a user identifier registered or to call the setIdentifier method on the editor instance beforehand.setEmailMarketingSubscriptionState(BatchEmailSubscriptionState state) method to BatchUserDataEditor.Inbox
hasLandingMessage property to BatchInboxNotificationContent.displayNotificationLandingMessage(BatchInboxNotificationContent notification) method to BatchInboxFetcher.Updated Batch to 1.19.2. Bumping your Android project's compileSdkVersion to 33 might be required. Xcode 13.3 required if your project uses bitcode.
Plugin
compileSdkVersion to 33 might be required.
Xcode 13.3 required if your project uses bitcode.Push
batch.push.requestNotificationAuthorization() API. This allows you to request for the new notification permission introduced in Android 13. See the documentation for more info.Updated Batch to 1.19.0. Bumping your Android project's compileSdkVersion to 31 might be required. Xcode 13.3 required if your project uses bitcode.
Plugin
compileSdkVersion to 31 might be required.
Xcode 13.3 required if your project uses bitcode.Inbox
Android: Move away from jCenter and use Maven Central.
Plugin
Updated dependencies so that the project can be built using Flutter 2.10. Bumping your Android project's compileSdkVersion to 31 might be required.
Plugin
compileSdkVersion to 31 might be required.Work around a Flutter issue where a wrong nullability annotation resulted in a debug app crashing when started from the home screen. The scenario is s
Plugin
Added support for the URL attribute and event data type.
Plugin
User
Removed isDeleted on BatchInboxNotificationContent as it doesn't work like it does on the native SDK due to plugin limitations.
Initial stable release 🎉
Changes since RC:
Inbox
isDeleted on BatchInboxNotificationContent as it doesn't work like it does on the native SDK due to plugin limitations.Fix limit and maxPageSize staying at their default values.
Inbox
limit and maxPageSize staying at their default values.Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →