NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #217 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.3
Last release 4 days ago
18 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
328 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
[iOS][macOS] fixed notification trigger scheduling to use the Gregorian calendar regardless of the device's current calendar. Thanks to the PR from Sa
[Android] fixed issue #2864 where the deprecated AlarmManagerCompat.setExact() method was being used. Thanks to the PR from Code Lover
AlarmManagerCompat.setExact() method was being used. Thanks to the PR from Code LoverYour coding agent can read these notes before it upgrades. Set up the MCP server →
[Android] fixed issue where cancelling a notification did not work for tag-based notifications when an action with showsUserInterface set to true was
showsUserInterface set to true was invoked. Thanks to the PR from Yokota YukiBreaking change bumped minimum Flutter SDK requirement to 3.44.0 and Dart SDK requirement to 3.12.0
compileSdk to 37 and updated readme to mention thisCXX_STANDARD 20)NullPointerException crash in setSmallIcon (Attempt to invoke virtual method 'int java.lang.Integer.intValue()' on a null object reference) when a scheduled notification is delivered with no icon, no persisted default icon, and a null legacy iconResourceId. This can happen when a notification serialized by an older version of the plugin fires after an app update. The application's own icon is now used as a fallback so notification delivery no longer crashes. Fixes #298 and #2049. Thanks to the PR from Michael Allendbus dependency version constraints to >=0.7.8 <0.9.0PlatformException being thrown when trying to show notifications when permissions have not been granted due to iOS 27 behavioural changes outside the control of the pluginApplies changes done as part of 22.3.3 hotfix
Applies changes done as part of 22.3.2 hotfix
[Windows] Breaking change bumped cmake minimum version to 3.14 and have plugin compile with at least C++ 20 (i.e. CXX_STANDARD 20)
CXX_STANDARD 20)[Android] added support for live update notifications. Example app has been updated to demonstrate usage. Thanks to the PR from Vasily Laushkin
dbus dependency version constraints to >=0.7.8 <0.9.0PlatformException being thrown when trying to show notifications when permissions have not been granted due to iOS 27 behavioural changes outside the control of the pluginBreaking change bumped minimum Flutter SDK requirement to 3.44.0 and Dart SDK requirement to 3.12.0
compileSdk to 37 and updated readme to mention thisNullPointerException crash in setSmallIcon (Attempt to invoke virtual method 'int java.lang.Integer.intValue()' on a null object reference) when a scheduled notification is delivered with no icon, no persisted default icon, and a null legacy iconResourceId. This can happen when a notification serialized by an older version of the plugin fires after an app update. The application's own icon is now used as a fallback so notification delivery no longer crashes. Fixes #298 and #2049. Thanks to the PR from Michael Allen[Android] fixed issues #2858 where for repeating notifications, the specified wall-clock time was not kept when daylight savings related transitions t
[iOS] fixed issue #2838 so that plugin longer throws PlatformExceptions that started on iOS 27 when permissions were not granted and when badge only n
PlatformExceptions that started on iOS 27 when permissions were not granted and when badge only notifications were triggered. This restores the behaviour of the plugin to as it was before. Thanks to the PR from Vasily Laushkindbus dependency version constraints to >=0.7.8 <0.9.0[macOS] fixed subtitle not showing up properly. Thanks to the PR from Soi (Jiwon Lee)
[Android][iOS][macOS] added openAppNotificationSettings() method. This opens the system settings UI where the user can manage notification permissions
openAppNotificationSettings() method. This opens the system settings UI where the user can manage notification permissions for the app. When not possible, on iOS, it opens the application's settings on iOS and on macOS, it opens the system settings notification pane. Thanks to the PR from hamadcc[Android][iOS][macOS] added support for callbacks to fire when a notification has been dismissed. This requires opting in by where the key requirement
dismissIsolate property added to the AndroidNotificationDetails and DarwinNotificationDetails class. This indicates which isolate should be used to handle when a notification has been dismissed. Note on macOS, there is no support for background isolates so callback will always fire on the main isolate despite what is specified. Please see example app for more details on how to set up handling dismissals. Thanks to the PR from from Vasily Laushkin[Android] added support for showBigPictureWhenCollapsed in BigPictureStyleInformation. Thanks to the PR from hiimax (Codematic)
showBigPictureWhenCollapsed in BigPictureStyleInformation. Thanks to the PR from hiimax (Codematic)NotificationResponseType.selectedNotificationAction. Thanks to the PR from fush1m1[Windows] Suppress warning around usage of experimental coroutines. This is to fix issue #2777
[Android] calling the requestNotificationPolicyAccess() method belonging to the AndroidFlutterLocalNotificationsPlugin class will now highlight associ
requestNotificationPolicyAccess() method belonging to the AndroidFlutterLocalNotificationsPlugin class will now highlight associated application. Thanks to the PR from Claudius KienleperiodicallyShow() the message when the UnsupportedError is thrown has been updated to say Windows devices cannot periodically show notifications instead. This has happened as a result of shifting the responsibility of reporting the UnsupportedError so it is done by flutter_local_notifications_windows instead of flutter_local_notificationsxml dependency so that supported range is >=6.5.0 <8.0.0[Android] calling the requestNotificationPolicyAccess() method belonging to the AndroidFlutterLocalNotificationsPlugin class will now highlight associ
requestNotificationPolicyAccess() method belonging to the AndroidFlutterLocalNotificationsPlugin class will now highlight associated application. Thanks to the PR from Claudius Kienlexml dependency so that supported range is >=6.5.0 <8.0.0[Web] Breaking change renamed the details parameter associated with the show() method to notificationDetails. This was done to be consistent with othe…
details parameter associated with the show() method to notificationDetails. This was done to be consistent with other APIs across all of the platformshasPermission and isPermissionDenied boolean properties associated with the WebFlutterLocalNotificationsPlugin class. This was done to simplify the plugin as the permissionStatus property already exists and can be usedisSupported property in the WebFlutterLocalNotificationsPlugin was not exposed[Web] added web platform support. Thanks to the initial PR from Levi Lesches and completion by Gaurav
periodicallyShow() the message when the UnsupportedError is thrown has been updated to say Windows devices cannot periodically show notifications instead. This has happened as a result of shifting the responsibility of reporting the UnsupportedError so it is done by flutter_local_notifications_windows instead of flutter_local_notificationsBreaking change bumped minimum Flutter SDK requirement to 3.38.1 and Dart SDK requirement to 3.10.0. Consequently the minimum OS requirements for each…
timezone dependencycompileSdk to 36 and updated readme to mention thisUIScene lifecycleUIScene lifecycleUNUserNotificationCenterDelegate to remove redundant available check and to be more specific that it should be done in the application:didFinishLaunchingWithOptions: methodflutter_timezone dependency in example appMigrated example app to UIScene lifecycle
UIScene lifecycleUIScene lifecycleUNUserNotificationCenterDelegate to remove redundant available check and to be more specific that it should be done in the application:didFinishLaunchingWithOptions: methodflutter_timezone dependency in example appBreaking change bumped minimum Flutter SDK requirement to 3.38.1 and Dart SDK requirement to 3.10.0.Consequently the minimum OS requirements for each…
timezone dependencycompileSdk to 36 and updated readme to mention this[iOS] added CarPlay notification support. Thanks to the PR from derrik f
ActiveNotification class now returns values for groupKey property if applicable. This depends on if the threadIdentifier was specified when creating the notification itself. Thanks to the PR from Kwon Tae Hyunguse_null_aware_elements linter issueBreaking change bumped minimum Flutter SDK requirement to 3.32.0 and Dart SDK requirement to 3.8.0
initialize()show()periodicallyShow()periodicallyShowWithDuration()cancel()zonedSchedule()startForegroundService()deleteNotificationChannelGroup()deleteNotificationChannel()getActiveNotificationMessagingStyle()LinuxNotificationCustomHint() method have now been converted to named parametersshowRawXml()zonedScheduleRawXml()details parameter in the show() and zonedSchedule() methods has been renamed to notificationDetailsonNotificationReceived in the initialize() method has been renamed to onDidReceiveNotificationResponsedetails parameter from the zonedScheduleRawXml() method as it was not actually used. Thanks to the PR from Levi LeschesAndroidIcon abstract classflutter_lints to apply linter rules[Android] fixed issue #2745 to export the AndroidIcon abstract class
AndroidIcon abstract classBreaking changes the positional parameters in the following methods have now been converted to named parameters across all platforms. Thanks to the PR…
initialize()show()periodicallyShow()periodicallyShowWithDuration()cancel()zonedSchedule()startForegroundService()deleteNotificationChannelGroup()deleteNotificationChannel()getActiveNotificationMessagingStyle()LinuxNotificationCustomHint() method have now been converted to named parametersshowRawXml()zonedScheduleRawXml()details parameter in the show() and zonedSchedule() methods has been renamed to notificationDetailsonNotificationReceived in the initialize() method has been renamed to onDidReceiveNotificationResponse[Android] updated Java compatibility version to 17
Breaking change bumped minimum Flutter SDK requirement to 3.32.0 and Dart SDK requirement to 3.8.0
details parameter from the zonedScheduleRawXml() method as it was not actually used. Thanks to the PR from Levi Leschesflutter_lints to apply linter rules[iOS][macOS] added requestProvidesAppNotificationSettings option to DarwinInitializationSettings class, and isProvidesAppNotificationSettingsEnabled t
requestProvidesAppNotificationSettings option to DarwinInitializationSettings class, and isProvidesAppNotificationSettingsEnabled to NotificationsEnabledOptions class. This allows applications to show a "Configure Notifications in <app name>" option when showing the context menu for an individual notification. This can be used for scenarios where an application can respond to the user selecting this option to show a custom page for controlling notification settings. Please note this whilst the API changes are applicable for iOS and macOS, the actual functionality only appears to be supported by Apple when it comes to iOS devices. See example app to see how this new functionality can be implemented. Thanks to the PR from Luke Memet[Windows] fixed issue where non-ASCII characters for the notification application name weren't being displayed properly. Thanks to the PR from yoyoIU
[Android] fixed issue #2675 where addition of invisible flag to notification actions could cause scheduled notifications with actions created prior to
invisible flag to notification actions could cause scheduled notifications with actions created prior to 19.4.0 to fail to show[Android] added ability to read dataMimeType and dataUri when calling getActiveNotifications() to read details of an active Android notification using
dataMimeType and dataUri when calling getActiveNotifications() to read details of an active Android notification using the messaging style. Thanks to the PR from Matt Bajorek[Windows] fixed issue #2648 where non-ASCII characters in the notification payload were not being handled properly. Thanks to the PR from yoyoIU
[Android][iOS][macOS] added cancelAllPendingNotifications() method for cancelling all pending notifications that have been scheduled. Thanks to the PR
cancelAllPendingNotifications() method for cancelling all pending notifications that have been scheduled. Thanks to the PR from Kwon Tae Hyung[macOS] removed redundant code that was only applicable on macOS versions lower than 10.14. This should be a non-functional change since 18.0.0 bumped
java.lang.NoClassDefFoundError around the plugin's Android unit tests. Thanks to the PR from Turtlepaw[Android] added support to bypass have notifications bypass the device's Do Not Disturb (DnD) settings. Thanks the PR from Michel v. Varendorff that a
hasNotificationPolicyAccess() method that checks if the application can modify the notification policyrequestNotificationPolicyAccess() method that was added the AndroidFlutterNotificationsPlugin class. This can be used request access for the calling application modify the notification policybypassDnd the property of the AndroidNotificationChannel class and channelBypassDnd to the AndroidNotificationDetails class. These can used to indicate if notifications associated with the channel can bypass the DnD settings of the devicemsix dev dependency in example app. This to fix the issue where the msix package stopped being able to created MSIX installers[iOS][macOS] added supported to specify the volume for critical alerts. Thanks to the PR from bannzai
[Android] Breaking change bumped compileSdk to 35 and updated readme to mention this
compileSdk to 35 and updated readme to mention thiscompileSdk version 35 (Android 15)sourceCompatibility and targetCompability should be set to JavaVersion.VERSION_11 (i.e. Java 11), and jvmTarget is set to 11uiLocalNotificationDateInterpretation parameter from zonedSchedule() method. This was done as it actually no relevant as of the 18.0.0 that dropped support for iOS versions older than 10, which in turn meant that the deprecated UILocalNotification APIs from Apple were no longer used. The corresponding UILocalNotificationDateInterpretation enum has already been removed as wellDarwinNotificationActionOption and DarwinNotificationCategoryOption are now enhanced enums with values accessible through the value property that are exactly the same as their native representations. Previously a bitwise left shift operation was applied to the index valueConverters header and implementation to FlutterLocalNotificationsConverters. This would likely not affect any users of the plugin. Done to fix/mitigate issues #2160 and #2529 where the original name could clashtimezone dependency so that minimum version is now 0.10.0plugin_platform_interface version to 2.1.8AndroidManifest.xml to request internet permissions so that release builds can download remote contentcompileSdk and targetSdkVersion of example app to 35[iOS][macOS] Breaking change renamed Converters header and implementation to FlutterLocalNotificationsConverters. This would likely not affect any use…
Converters header and implementation to FlutterLocalNotificationsConverters. This would likely not affect any users of the plugin. Done to fix/mitigate issues #2160 and #2529 where the original name could clashBreaking change bumped minimum Flutter SDK requirement to 3.22.0 and Dart SDK requirement to 3.4.0. The minimum supported Android version is now 5.0 (…
compileSdk version 35 (Android 15)sourceCompatibility and targetCompability should be set to JavaVersion.VERSION_11 (i.e. Java 11), and jvmTarget is set to 11plugin_platform_interface version to 2.1.8AndroidManifest.xml to request internet permissions so that release builds can download remote content[Android] Breaking change bumped compileSdk to 35 and updated readme to mention this
compileSdk to 35 and updated readme to mention thiscompileSdk and targetSdkVersion of example app to 35[Windows] Breaking change Reworked the APIs around custom images and audio. Check the updated example for more details, but in short:
WindowsNotificationAudio.fromFile(), use WindowsNotificationAudio.asset()WindowsImage.file(), use WindowsImage(). See the docs for what URIs are supportedMsixUtils.hasPackageIdentity() and MsixUtils.assetUri(). You shouldn't need to use .assetUri() directly, but it may be helpful to check .hasPackageIdentity() to know what features your application can support.FlutterLocalNotificationsWindows.isValidXml() for testing raw XML.[iOS][macOS] Breaking changes the DarwinNotificationActionOption and DarwinNotificationCategoryOption are now enhanced enums with values accessible th…
DarwinNotificationActionOption and DarwinNotificationCategoryOption are now enhanced enums with values accessible through the value property that are exactly the same as their native representations. Previously a bitwise left shift operation was applied to the index value[Windows] Fixed an issue that happens with MSIX app builds. Thanks to PR from Levi Lesches
Breaking change bumped minimum Flutter SDK requirement to 3.19.0 and Dart SDK requirement to 3.3.0
uiLocalNotificationDateInterpretation parameter from zonedSchedule() method. This was done as it actually no relevant as of the 18.0.0 that dropped support for iOS versions older than 10, which in turn meant that the deprecated UILocalNotification APIs from Apple were no longer used. The corresponding UILocalNotificationDateInterpretation enum has already been removed as welltimezone dependency so that minimum version is now 0.10.0Added upper bound constraints for timezone dependency. This is to allow the plugin and apps pull version 0.10.x if constraints are satisified. Future
timezone dependency but this approach is being used at the moment as version 0.10.0 of the time timezone package introduces a dependency on http package. Directly bumping the flutter_local_notifications dependency on timezone could have introduced dependency conflictsBreaking changes Bumped minimum Flutter SDK requirement to 3.13. Consequently the minimum OS requirements for each platform has been updated as well
androidAllowWhileIdle parameter from zonedSchedule() and periodicallyShow() methods. androidScheduleMode is now a required parameterregisterWith() method that has been added to each implementation. This affects the following platforms/classes where the registerWith() method was added
AndroidFlutterLocalNotificationsPluginIOSFlutterLocalNotificationsPluginMacOSFlutterLocalNotificationsPluginonDidReceiveLocalNotification callback as this was only relevant on iOS versions older than 10AndroidManifest.xml file to include details of what's needed for foreground services. Note these details were already available in the API docsIncluded changes from 17.2.4 release that was done to add in a privacy manifest file to macOS implementation
[iOS] Breaking change Removed onDidReceiveLocalNotification callback as this was only relevant on iOS versions older than 10
onDidReceiveLocalNotification callback as this was only relevant on iOS versions older than 10Breaking changes Bumped minimum Flutter SDK requirement to 3.13. Consequently the minimum OS requirements for each platform has been updated as well
androidAllowWhileIdle parameter from zonedSchedule() and periodicallyShow() methods. androidScheduleMode is now a required parameterregisterWith() method that has been added to each implementation. This affects the following platforms/classes where the registerWith() method was added
AndroidFlutterLocalNotificationsPluginIOSFlutterLocalNotificationsPluginMacOSFlutterLocalNotificationsPluginAndroidManifest.xml file to include details of what's needed for foreground services. Note these details were already available in the API docs[macOS] added privacy manifest file
[Android] fixed #2309 where plugin runs into an exception getting the sound information for a notification channel. Thanks to the PR from Goddchen
Bumped dependency on flutter_local_notifications_linux to 4.0.1. Updated app-facing packaging to no longer create and register the Linux implementatio
flutter_local_notifications_linux to 4.0.1. Updated app-facing packaging to no longer create and register the Linux implementation as this will now be handled by the flutter_local_notifications_linux package itselfautoCancel property for the action was set to true. Thanks to the PR from Remco AnkerFixed accidental change done in example app as part of 17.2.0 where it made use of SCHEDULE_EXACT_ALARM permission instead of USE_EXACT_ALARM
SCHEDULE_EXACT_ALARM permission instead of USE_EXACT_ALARMUpdated Gradle setup readme section around specifying AGP version to include link to Flutter documentation for apps that are using the declarative Plu
[Android] fixed issue #2329 where a compilation issue could occur due to ambiguity between Android APIs being called. Thanks to the PR from Greg Price
[Android][iOS][macOS] added periodicallyShowWithDuration() method that allows for having a notification periodically shown based on a specified durati
periodicallyShowWithDuration() method that allows for having a notification periodically shown based on a specified duration. The duration will need to be at least a minute. Thanks to the PR from Mateusz ŁuczakrequestFullScreenIntentPermission() to the AndroidFlutterNotificationsPlugin class. This allows app to request the full-screen intent permission. Updated the documentation around full-screen intent notifications accordingly as wellAndroidManifest.xml file of the example to state that it requests the USE_EXACT_ALARM only for ease of use. Developers will need to check if they should be using the SCHEDULE_EXACT_ALARM permission instead[Android] fixed issue 2318 where an exception could occur on calling the getNotificationChannels() method from the AndroidFlutterLocalNotificationsPlu
getNotificationChannels() method from the AndroidFlutterLocalNotificationsPlugin class. This happened when Android found that the audio attributes associated with the channel was null. The plugin will now coalesce the null value to indicate that the usage of the audio is for notifications as per https://developer.android.com/reference/android/media/AudioAttributes#USAGE_NOTIFICATION. On the Dart side, this would correspond to the AudioAttributesUsage.notification enum value[Android] fixes issue #2299 where within the range of the max integer value of epoch time passed to a messaging style would result in a casting except
One column per quarter.