NewYour coding agent can read the release notes before it upgrades.Set up the MCP server โ
pub.dev
pub.dev, #973 most downloaded on pub.dev
OneSignal is a free push notification service for mobile apps. This plugin makes it easy to integrate your flutter app with OneSignal
Latest stable
5.8.0
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
111 releases ยท first in 2019
Drag across the ruler to compare, or tap a release to open it.
feat: [SDK-5700] add FlutterFramework SwiftPM dependency
Channels: Current
Update iOS SDK from 5.8.0 to 5.8.1
Channels: Current
fix: [SDK-5608] reset language with '' on Android and standardize demo push UI
Your coding agent can read these notes before it upgrades. Set up the MCP server โ
Channels: Current
fix: [SDK-5332] validate public API inputs to prevent native crashes
Channels: Current
> Deployment target raised to iOS 15
Channels: Current
[!WARNING] Deployment target raised to iOS 15
This version raises the minimum iOS deployment target from iOS 12.0 to iOS 15.0. If your app still targets earlier versions, you will need a OneSignal Flutter SDK running
5.6.xor earlier.
Update iOS SDK from 5.6.2 to 5.6.3
Channels: Current
Update Android SDK from 5.10.0 to 5.10.2
Channels: Current
fix: update iOS minimum version to 12
Channels: Current
fix: restore the deprecated 2-arg NSE selector (OneSignal-iOS-SDK#1737)
Channels: Current
Update Android SDK from 5.9.8 to 5.9.9
Channels: Current
Update Android SDK from 5.9.7 to 5.9.8
Channels: Current
Update iOS SDK from 5.5.4 to 5.5.5
Channels: Current
Update Android SDK from 5.9.6 to 5.9.7
Update Android SDK from 5.9.5 to 5.9.6
Channels: Current
Update Android SDK from 5.9.4 to 5.9.5
Channels: Current
Update Android SDK from 5.9.3 to 5.9.4
Channels: Current
Nothing published for this version
feat: [SDK-4194] support disabling location module
Channels: Current
fix(android): [SDK-4407] deliver notification events when firebase_messaging is present
Channels: Current
Update Android SDK from 5.9.2 to 5.9.3
Channels: Current
fix: [SDK-4722] guard getNotifications() in onDetachedFromEngine
Channels: Current
Update Android SDK from 5.8.1 to 5.9.2
Channels: Current
login() is called before requestPermission() (#2627)fix(android): unsubscribe click listener when Flutter engine detaches
Channels: Current
Update Android SDK from 5.8.0 to 5.8.1
Channels: Current
Update Android SDK from 5.7.7 to 5.8.0
Channels: Stable
Update Android SDK from 5.7.6 to 5.7.7
Channels: Current
feat: add Swift Package Manager support for iOS plugin
Channels: Current
Swift Package Manager (SPM) Support: Flutter's SPM integration is used automatically when enabled (the default in newer Flutter versions). No changes are needed for new projects.
Migrating from CocoaPods to SPM: Existing projects using CocoaPods can migrate by:
enable-swift-package-manager: false from pubspec.yaml (if present)Podfile, Podfile.lock, and Pods/ directoryios/Flutter/Debug.xcconfig and ios/Flutter/Release.xcconfigflutter run, Flutter adds SPM integration automaticallyfix: [SDK-4193] suppress unchecked cast warnings in Android bridge
Channels: Current
Update Android SDK from 5.7.2 to 5.7.3
Channels: Current
Update Android SDK from 5.7.1 to 5.7.2
Channels: Current
Update Android SDK from 5.6.2 to 5.7.1
Update Android SDK from 5.6.1 to 5.6.2
Channels: Current
Update iOS SDK from 5.4.0 to 5.4.1
Channels: Current
This release introduces Custom Events support for the react native sdk.
Channels: Current
This release introduces Custom Events support for the react native sdk.
Please see documentation on Custom Events.
This beta release introduces Custom Events support for the flutter sdk.
Channels: Beta
This beta release introduces Custom Events support for the flutter sdk.
Please see documentation on Custom Events.
We appreciate your experience and feedback using this beta version!
Update Android SDK from 5.1.35 to 5.3.0-alpha-01 Support for custom events. See release notes for full details.
Update iOS SDK from 5.2.14 to 5.4.0-alpha-01 Support for custom events. See release notes for full details.
Update iOS SDK from 5.2.15 to 5.2.16
Channels: Current
fix: address hot reloading issues
Channels: Current
fix: complete lifecycleInit Future on Android
Channels: Stable
OSUserChangedState (#1054)NSInvalidArgumentException that happens on rare occasions when localized description is not copied properly (https://github.com/OneSignal/OneSignal-iOS-SDK/pull/1594)Update Android SDK from 5.1.34 to 5.1.35
Channels: Current
Update Android SDK from 5.1.34 to 5.1.35
Update iOS SDK from 5.2.13 to 5.2.14
fix(badges): drop deprecated applicationIconBadgeNumber usage
Channels: Current
Update Android SDK from 5.1.33 to 5.1.34
Update iOS SDK from 5.2.10 to 5.2.13
Switch docs for setShared and isShared #995
Channels: Current
Update Android SDK from 5.1.29 to 5.1.33 | select fixes listed
Please await version 5.3.2 which includes the same changes
๐ง Do not use ๐ง
Please await version 5.3.2 which includes the same changes
[breaking] Remove deprecated Android v1 embedding references
Update Android SDK from 5.1.26 to 5.1.29 | select fixes listed
Update iOS SDK from 5.2.9 to 5.2.10 | release notes
๐ง Native SDK Dependency Updates Only
๐ Bug Fixes
๐ Bug Fixes
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.8...5.2.9
๐ง Native SDK Dependency Updates Only
๐ Bug Fixes
๐ Bug Fixes
โจ Improvements
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.7...5.2.8
๐ง Native SDK Dependency Updates Only
๐ Bug Fixes
โจ Improvements
โจ Improvements
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.6...5.2.7
๐ง Native SDK Dependency Updates Only
๐ Bug Fixes
โจ Improvements
โจ Improvements
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.5...5.2.6
Fix ending an already ended session
๐ Bug Fixes
โจ Improvements
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.3...5.2.5
set compileSdkVersion 34 to fix build errors
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.3...5.2.4
Removed duplicate "longer" MIGRATION_GUIDE.md
๐ Bug Fixes
โจ Improvements
๐ Bug Fixes
โจ Improvements
๐ ๏ธ Maintenance
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.2...5.2.3
chore: add warning for identity verification in https://github.com/OneSignal/OneSignal-Flutter-SDK/pull/901
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.0...5.2.2
๐ง Native SDK Dependency Updates
5.1.13 to 5.1.15For full changes, see the native release notes
5.2.0 to 5.2.1Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.2.0...5.2.1
Starting with iOS 17.2, Live Activities can now be started via push notification (Apple's documentation). This change enhances the OneSignal SDK to pr
Starting with iOS 17.2, Live Activities can now be started via push notification (Apple's documentation). This change enhances the OneSignal SDK to provide application's access to the full suite of Live Activity functionality.
To use Push To Start Live Activities, see documentation on How to start a Live Activity with a remote push notification.
Default Live Activity
The concept of a "Default" Live Activity has been established in the SDK, which eliminates the need for a customer app to define and manage their own ActivityAttributes. The primary use case of the "Default" Live Activity is to facilitate easier cross-platform adoption.
OneSignal.LiveActivities.setupDefault() which tells the OneSignal SDK to manage the LiveActivity lifecycle for the DefaultLiveActivityAttributes type. When calling this method, a customer can use both push-to-start and push-to-update notifications to start/update/end their Default Live Activity.OneSignal.LiveActivities.startDefault(activityId, activityAttributes, initialContentState) which allows a customer app to start a live activity based on the DefaultLiveActivityAttributes type "in app".Four New APIs for Live Activities
OneSignal.LiveActivities.setupDefault()
OneSignal.LiveActivities.startDefault(activityId, activityAttributes, initialContentState)
OneSignal.LiveActivities.setPushToStartToken(String activityType, String token)
OneSignal.LiveActivities.removePushToStartToken(String activityType)
Please see the PR description for more details.
5.1.10 to 5.1.13OneSignal-Install-Id that allows the OneSignal's backend know where traffic is coming from (2072)5.1.6 to 5.2.0Update Android SDK from `5.1.9` to `5.1.10`
Update Android SDK from 5.1.9 to 5.1.10
Update iOS SDK from 5.1.5 to 5.1.6
Full Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.1.5...5.1.6
Update Android SDK from `5.1.8` to `5.1.9`
Update Android SDK from 5.1.8 to 5.1.9
AndroidManifest options to override In-App Messages gray overlay and dropshadow<meta-data android:name="com.onesignal.inAppMessageHideGrayOverlay" android:value="true"/>
<meta-data android:name="com.onesignal.inAppMessageHideDropShadow" android:value="true"/>
Update iOS SDK from 5.1.4 to 5.1.5
plist option to disable itplist option to override and hide the gray overlay to In-App MessagesOneSignal_in_app_message_hide_gray_overlay
OneSignal_in_app_message_hide_drop_shadow
Update Android SDK from `5.1.6` to `5.1.8`
Update Android SDK from 5.1.6 to 5.1.8
Update iOS SDK from 5.1.3 to 5.1.4
Fix Live Activities methods were not working due to bridge error
๐ Bug Fixes
๐ New Methods
Update Android SDK from `5.1.2` to `5.1.6`
Update Android SDK from 5.1.2 to 5.1.6
firebase-messaging and play-services-basementgetAppContext when the SDK is initializing: linkUpdate iOS SDK from 5.1.0 to 5.1.3
Please use version 5.1.2, which contains the same changes.
๐ง Do not use ๐ง
Added the namespace property in build.gradle for AGP 8 #825
๐ New Methods
getTags method #804๐ง Maintenance
๐ Bug Fixes
requestPermission call when already granted #806โ ๏ธ Behavior Changes โ ๏ธ
OneSignal.Location.setShared(true)5.0.4 to 5.1.0: Release notes5.0.4 to 5.1.2: Release notesFull Changelog: https://github.com/OneSignal/OneSignal-Flutter-SDK/compare/5.0.4...5.1.0
One column per quarter.