NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #218 most downloaded on pub.dev
A cross platform plugin for displaying and scheduling local notifications for Flutter applications with the ability to customise for each platform.
Latest stable
23.0.2
Last release 3 days ago
13 Nov 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
9 years old
327 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
[iOS] Added requestPermissions() method to IOSFlutterLocalNotificationsPlugin class. This can be used to request notification permissions separately f
requestPermissions() method to IOSFlutterLocalNotificationsPlugin class. This can be used to request notification permissions separately from plugin initialisation. To facilitate this the IOSFlutterLocalNotificationsPlugin and AndroidFlutterLocalNotificationsPlugin now expose a static instance property that can be used obtain the platform-specific implementation of the plugin so that platform-specific methods can be used. Thanks to the PR from Dariusz ŁukszagetNotificationAppLaunchDetails() is intended to be used more on if a notification from this plugin triggered launch an application[iOS] Added ability to set badge number. Thanks to PR from FelixYew
Your coding agent can read these notes before it upgrades. Set up the MCP server →
No functional changes. Fixed a reported formatting issue.
FlutterLocalNotificationsPlugin.private() on how it could be used for testingFlutterLocalNotificationsPlugin.private() named constructor may be of use[Android] minor optimisation on scheduling related code so that Gson instance is reused instead of being rebuilt each time
Gson instance is reused instead of being rebuilt each timeSupport v2 Android embedding. Note that there is currently a known issue in the Flutter SDK that will cause onSelectNotification to fire twice on Andr
onSelectNotification to fire twice on Android. The fix is in the master channel but hasn't rolled out to other channels. Subscribe to the issue for updates.onSelectNotification to fire twice on Android. The fix is in the master channel but hasn't rolled out to other channels. Subscribe to the issue for updates.Retroactively updated changelog for 1.1.0 to indicate breaking change on moving to using platform interface
NotificationAppLaunchDetails via main pluginPassing a null notification id now throws an ArgumentError. Thanks to PR from talmor_guy
ArgumentError. Thanks to PR from talmor_guyArgumentError when notification id is not within range of a 32-bit integer[Android] Added ability to specify timeout duration of notification
Breaking change Plugin callbacks are no longer publicly accessible
flutter_local_notifications_platform_interface version 1.0.1. This allows for platform-specific
implementations of the platform interface to now be accessible.flutter_local_notifications_platform_interface version 1.0.1. This allows for platform-specific implementations of the platform interface to now be accessible. Note that the plugin will check which platform the plugin is running on.
Note: this may have inadvertently broke some tests for users as the plugin now checks which platform the plugin is executing code on and would throw an UnimplementedError since neither iOS or Android can be detected. Another issue is that NotificationAppLaunchDetails was no longer exposed via the main plugin. Please upgrade to 1.1.3 to have both of these issues fixedMethodChannel argument has been removed from the named constructor that was visible for testing purposesBreaking change [iOS] Added checks to ensure callbacks are only invoked for notifications originating from the plugin to improve compatibility with ot…
update readme with Swift example for cancelling local notifications in AppDelegate
UILocalNotification iOS APIs when trying to prevent local notifications from appearing in the scenario where user has uninstalled the app whilst there are pending notification requests, reinstalled the app and ran it again.update plugin pubspec to point to new plugin location in repo
Include notes in getting started section to emphasise that the steps in the integration guide for each platform needs to be done.
Added support for media notifications. This currently only supports showing the specified image as album artwork. Thanks to the PR by gianlucaparadise
Fix readme where Objective-C was written twice
Updates to enable better compatibility with other notification plugins
UNUserNotificationCenterDelegate. This is to enable compatibility with other plugins that display notifications. Developers must now do this themselves. Refer to the updated iOS integration section for more info on thismeta packageFix typo in readme. Thanks to PR submitted by Michael Arndt
initialize should only be called once on app startup.Add note to readme that plugin initialisation be done as part of showing the first page of the app.
Update example to fix issue 372 around app not firing onSelectNotification having switched to using streams and initialising the app in the main funct
onSelectNotification having switched to using streams and initialising the app in the main function.[iOS] Fix issue 336 where a native crash occurred after creating a notification with a null body
[Android] Changed intents to use the FLAG_UPDATE_CURRENT flag instead of FLAG_CANCEL_CURRENT as alarms weren't being cleared out properly when updatin
FLAG_UPDATE_CURRENT flag instead of FLAG_CANCEL_CURRENT as alarms weren't being cleared out properly when updating or cancel a notification. Thanks to WJQ for submitting the PR to address the cancellation issueRemove ScheduledAndroidNotificationPrecision enum that wasn't being used
ScheduledAndroidNotificationPrecision enum that wasn't being used[iOS] Fix issue 295 where onSelectNotification callback wasn't trigger when a notification had been tapped on whilst the app was terminated
onSelectNotification callback wasn't trigger when a notification had been tapped on whilst the app was terminatedUpdate comment in example around grouped notifications to clarify that the summary notification ia required for all versions of Android
[iOS] Accepted PR from Josh Burton that improves ability for plugin to work in multiple isolate by moving state to instance variables
onDidReceiveLocalNotification callback to trigger on iOS 10+Breaking change Bump minimum Flutter version to 1.5.0
androidAllowWhileIdle to schedule method. This will allow notifications to still display at the specified time when the Android device is in an low-power idle mode.[Android] Added ability to specify the "ticker" text. Thanks to PR submitted by Zhang Jing
Updated readme to include information about OS limits related to scheduled notifications
Started adding Cirrus CI configuration and include CI status badge as part of readme
* Fix build status badge
Breaking change [Android] Updated to Gradle 5.1.1 and Android Gradle plugin has been updated to 3.4.0 (aligns with Android Studio 3.4 release). Exampl…
[Android/iOS] Added pendingNotificationRequests method. This will return a list of pending notification requests that have been scheduled to be shown
pendingNotificationRequests method. This will return a list of pending notification requests that have been scheduled to be shown in the future. Updated example app to include sample code for calling the methodFuture<void> instead of Future as per Dart guidelinesBreaking change [Android] Updated Gradle plugin to 3.3.2
initialize method. This is due to the fact the name of the default icon wasn't being cached in previous ones but this has now changed so it's cached in shared preferences from this version onwardsFix for when multiple isolates use the plugin. Thanks to PR submitted by xtelinco
channelAction field to the AndroidNotificationDetails class. This provides options for managing notification channels on Android. Default behaviour is to create the notification channel if it doesn't exist (which was what it it use to do). Another option is to update the details of the notification channel. Example app has been updated to demonstrate how to update a notification channel when sending a notificationUpdated Gradle plugin of example app to 3.3.1
Readme corrections and add information on migrating to AndroidX
Highlight note on migrating to AndroidX more in readme
Breaking change Migrated to use AndroidX as the Android support libraries are deprecated. There shouldn't be any functional changes. Developers may re…
Fix issue 160 so that notifications created with the schedule on Android will appear at the exact date and time they are scheduled
schedule on Android will appear at the exact date and time they are scheduledBreaking change removed registerUNNotificationCenterDelegate argument for the IOSInitializationSettings class as it wasn't actually used.
registerUNNotificationCenterDelegate argument for the IOSInitializationSettings class as it wasn't actually used.didReceiveLocalNotification delegate method in iOS and allow developers to handle the associated callback in Flutter. Added a onDidReceiveLocalNotificationCallback argument to the IOSInitializationSettings class to enable this and updated the sample code to demonstrate the usage. This should resolve issue 14.Breaking change Fix naming of onDidReceiveLocalNotification property in the IOSInitializationSettings class (was previously named onDidReceiveLocalNot…
onDidReceiveLocalNotification property in the IOSInitializationSettings class (was previously named onDidReceiveLocalNotificationCallback by accident)* Fix changelog
Merged PR from Aine LLC (ganessaa) to fix issue 140 where scheduled notifications were shown immediately on iOS versions before 10. Note that this iss
hideExpandedLargeIcon flag within thr BigPictureStyleInformation class. This provides a solution for issue 136. Updated the example to demonstrateBreaking change Fix issue 127 by changing plugin to Android Support Library version 27.1.1, compile and target SDK version to 27 due to issues Flutter…
Update changelog to indicate when MessageHandler typedef got renamed (in 0.4.1) as raised in issue 132
MessageHandler typedef got renamed (in 0.4.1) as raised in issue 132Breaking change renamed the selectNotification callback exposed by the initialize function to onSelectNotification
selectNotification callback exposed by the initialize function to onSelectNotificationMessageHandler typedef to SelectNotificationCallbackArgumentError is thrown when a value is out of range.Remove unused code in example app
[Android] Fix issue 112 where big picture notifications wouldn't show
[Android] Added ability to show progress notifications and updated example app to demonstrate how to display them
[Android] Fix issue 71 where the wrong time on when the notification occurred is being displayed. Breaking change this involves changing it the receiv…
getNotificationAppLaunchDetails() method that could be used to determine if the app was launched via notification (raised in issue 99)showDailyAtTime and showWeeklyAtDayAndTime methods may not show notifications that should appear the next day. Thanks to Jeff Scaturro for submitting the PR to fix this.BREAKING CHANGES restructured code so that only a single import statement is now needed to use the plugin. Classes that had the platform (Android/iOS) as a suffix are now prefixes to improve readability of code and follow the recommendations for writing Dart code i.e. write code that reads more like a sentence. The following have been renamed
[Android] Ability to set the large icon used for each notification. See example app for sample code
[Android] Ability to create a notification with the big picture style. See example app for sample code
Correct license text
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.