Component: UNNotification 
--------------------------

User notifications for iOS and MacOS

You can receive push notifications as well as use local notifcations to remind user about events and locations.  
See [WindowsUserNotification](component_WindowsUserNotification.md) functions for Windows.

| Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|
| [7.2](newinversion72.md "First functions introduced with version 7.2.") / [13.0](newinversion130.md "Newest functions in version 13.0.") | ✅ 91% | ❌ No | ❌ No | 🔶 2%, on macOS | ✅ Yes |

  
| Item | Details |
|:--|:--|
| [UNNotification.Action](UNNotificationAction.md)   Queries identifier of action. | Mac/iOS   7.2 |
| [UNNotification.AddFile](UNNotificationAddFile.md)   Adds an attachment to the notification. | Mac/iOS   10.4 |
| [UNNotification.AddImage](UNNotificationAddImage.md)   Adds an attachment to the notification. | Mac/iOS   10.4 |
| [UNNotification.AddUserInfo](UNNotificationAddUserInfo.md)   Adds user info. | Mac/iOS   7.2 |
| [UNNotification.AuthorizationError](UNNotificationAuthorizationError.md)   Queries error for notification authorization. | Mac/iOS   7.3 |
| [UNNotification.AuthorizationGranted](UNNotificationAuthorizationGranted.md)   Queries whether notifications are allowed. | Mac/iOS   7.3 |
| [UNNotification.Badge](UNNotificationBadge.md)   Queries badge number. | Mac/iOS   7.2 |
| [UNNotification.Body](UNNotificationBody.md)   Queries the body of the notification. | Mac/iOS   7.2 |
| [UNNotification.CategoryIdentifier](UNNotificationCategoryIdentifier.md)   Queries the category identifier. | Mac/iOS   7.2 |
| [UNNotification.Date](UNNotificationDate.md)   Queries the date displayed on the notification. | Mac/iOS   7.2 |
| [UNNotification.Deliver](UNNotificationDeliver.md)   Delivers notification now. | Mac/iOS   9.3 |
| [UNNotification.DeliveredNotifications](UNNotificationDeliveredNotifications.md)   Queries list of delivered notifications. | Mac/iOS   7.2 |
| [UNNotification.GetDescription](UNNotificationGetDescription.md)   Queries description of notification. | Mac/iOS   9.3 |
| [UNNotification.Identifier](UNNotificationIdentifier.md)   Queries identifier. | Mac/iOS   7.2 |
| [UNNotification.IsRegisteredForRemoteNotifications](UNNotificationIsRegisteredForRemoteNotifications.md)   Checks whether we can get remote notifications. | Mac/iOS   7.2 |
| [UNNotification.LaunchImageName](UNNotificationLaunchImageName.md)   Queries launch image name. | iOS   7.2 |
| [UNNotification.List](UNNotificationList.md)   Lists all IDs of notification objects. | Mac/iOS   13.0 |
| [UNNotification.New](UNNotificationNew.md)   Creates a new notification. | Mac/iOS   7.2 |
| [UNNotification.NextTriggerDate](UNNotificationNextTriggerDate.md)   Quereis next trigger date. | Mac/iOS   7.2 |
| [UNNotification.NotificationSettings](UNNotificationNotificationSettings.md)   Checks notification settings. | Mac/iOS   7.2 |
| [UNNotification.PendingNotificationRequests](UNNotificationPendingNotificationRequests.md)   Queries list of pending notifications. | Mac/iOS   7.2 |
| [UNNotification.Region](UNNotificationRegion.md)   Queries region of location based trigger. | iOS   7.2 |
| [UNNotification.Release](UNNotificationRelease.md)   Release reference to notification. | Mac/iOS   7.2 |
| [UNNotification.ReleaseAll](UNNotificationReleaseAll.md)   Releases all notifications. | Mac/iOS   7.2 |
| [UNNotification.RemoteNotificationsDeviceToken](UNNotificationRemoteNotificationsDeviceToken.md)   Queries device token. | Mac/iOS   7.2 |
| [UNNotification.RemoteNotificationsError](UNNotificationRemoteNotificationsError.md)   Queries the error from remote notification registration. | Mac/iOS   7.2 |
| [UNNotification.RemoveAllDeliveredNotifications](UNNotificationRemoveAllDeliveredNotifications.md)   Removes all delivered notifications from system. | Mac/iOS   7.2 |
| [UNNotification.RemoveAllPendingNotificationRequests](UNNotificationRemoveAllPendingNotificationRequests.md)   Removed all pending notification requests. | Mac/iOS   7.2 |
| [UNNotification.RemoveDeliveredNotificationsWithIdentifiers](UNNotificationRemoveDeliveredNotificationsWithIdentifiers.md)   Removes delivered notifications from system. | Mac/iOS   7.2 |
| [UNNotification.RemovePendingNotificationRequestsWithIdentifiers](UNNotificationRemovePendingNotificationRequestsWithIdentifiers.md)   Removed pending notification requests. | Mac/iOS   7.2 |
| [UNNotification.Repeats](UNNotificationRepeats.md)   Queries repeat status. | Mac/iOS   7.2 |
| [UNNotification.Schedule](UNNotificationSchedule.md)   Schedule notification. | Mac/iOS   7.2 |
| [UNNotification.SetActionScript](UNNotificationSetActionScript.md)   Sets which script to call when a notification’s action is triggered. | Mac/iOS   7.2 |
| [UNNotification.SetBadge](UNNotificationSetBadge.md)   Sets the badge number. | Mac/iOS   7.2 |
| [UNNotification.SetBody](UNNotificationSetBody.md)   Sets the body of the notification. | Mac/iOS   7.2 |
| [UNNotification.SetCalendarDateTrigger](UNNotificationSetCalendarDateTrigger.md)   Sets a calendar based trigger. | Mac/iOS   9.3 |
| [UNNotification.SetCalendarTrigger](UNNotificationSetCalendarTrigger.md)   Sets a calendar based trigger. | Mac/iOS   7.2 |
| [UNNotification.SetCategoryIdentifier](UNNotificationSetCategoryIdentifier.md)   Sets the category identifier. | Mac/iOS   7.2 |
| [UNNotification.SetLaunchImageName](UNNotificationSetLaunchImageName.md)   Sets the launch image name. | iOS   7.2 |
| [UNNotification.SetLocationTrigger](UNNotificationSetLocationTrigger.md)   Sets a location trigger. | iOS   7.2 |
| [UNNotification.SetNFCScript](UNNotificationSetNFCScript.md)   Sets NFC trigger script. | iOS   9.4 |
| [UNNotification.SetScript](UNNotificationSetScript.md)   Sets which script to call when a notification is presented. | Mac/iOS   7.2 |
| [UNNotification.SetSound](UNNotificationSetSound.md)   Sets the sound to play. | Mac/iOS   7.2 |
| [UNNotification.SetSubTitle](UNNotificationSetSubTitle.md)   Sets the subtitle of the notification. | Mac/iOS   7.2 |
| [UNNotification.SetThreadIdentifier](UNNotificationSetThreadIdentifier.md)   Sets thread identifier. | Mac/iOS   7.2 |
| [UNNotification.SetTimeIntervalTrigger](UNNotificationSetTimeIntervalTrigger.md)   Sets a time base trigger. | Mac/iOS   7.2 |
| [UNNotification.SetTitle](UNNotificationSetTitle.md)   Sets title of notification. | Mac/iOS   7.2 |
| [UNNotification.SubTitle](UNNotificationSubTitle.md)   Queries subtitle of notification. | Mac/iOS   7.2 |
| [UNNotification.ThreadIdentifier](UNNotificationThreadIdentifier.md)   Queries thread identifier. | Mac/iOS   7.2 |
| [UNNotification.TimeInterval](UNNotificationTimeInterval.md)   Queries time interval for time based trigger. | Mac/iOS   7.2 |
| [UNNotification.Title](UNNotificationTitle.md)   Queries title of notification. | Mac/iOS   7.2 |
| [UNNotification.Type](UNNotificationType.md)   Queries type of notification. | Mac/iOS   7.2 |
| [UNNotification.UserInfoKeys](UNNotificationUserInfoKeys.md)   Queries keys for user info. | Mac/iOS   7.2 |
| [UNNotification.UserInfoValue](UNNotificationUserInfoValue.md)   Queries value for given key in user info. | Mac/iOS   7.2 |

54 functions shown.

These functions are free to use.

### Release notes

- **Version 14.3**
    - Changed WindowsUserNotification and [UNNotification](https://www.mbsplugins.eu/component_UNNotification.shtml) functions to be free to use without license.
    - Improved [UNNotification](https://www.mbsplugins.eu/component_UNNotification.shtml) functions to work better in FileMaker 21, so both ways can be used together.
- **Version 13.0**
    - Added [UNNotification.List](https://www.mbsplugins.eu/UNNotificationList.shtml) function.
- **Version 10.5**
    - Fixed main thread warning for [UNNotification.IsRegisteredForRemoteNotifications](https://www.mbsplugins.eu/UNNotificationIsRegisteredForRemoteNotifications.shtml) function.
- **Version 10.4**
    - Added [UNNotification.AddFile](https://www.mbsplugins.eu/UNNotificationAddFile.shtml) and [UNNotification.AddImage](https://www.mbsplugins.eu/UNNotificationAddImage.shtml) functions.
- **Version 10.0**
    - Fixed a bug in [UNNotification.New](https://www.mbsplugins.eu/UNNotificationNew.shtml) to avoid endless loop.
- **Version 9.4**
    - Added [UNNotification.SetNFCScript](http://www.mbsplugins.eu/UNNotificationSetNFCScript.shtml) function for background scanning with URL trigger in NFC card for iOS.
- **Version 9.3**
    - Added [UNNotification.Deliver](http://www.mbsplugins.eu/UNNotificationDeliver.shtml), [UNNotification.GetDescription](http://www.mbsplugins.eu/UNNotificationGetDescription.shtml) and [UNNotification.SetCalendarDateTrigger](http://www.mbsplugins.eu/UNNotificationSetCalendarDateTrigger.shtml) functions.
    - Changed [UNNotification](http://www.mbsplugins.eu/component_UNNotification.shtml) functions to initialize on demand and not a startup.
- **Version 9.1**
    - Added providesAppNotificationSettings, showPreviewsSetting and criticalAlertSetting for [UNNotification.NotificationSettings](http://www.mbsplugins.eu/UNNotificationNotificationSettings.shtml) function.
    - Added [UNNotification](http://www.mbsplugins.eu/component_UNNotification.shtml) functions for MacOS 10.14 and newer.
    - Changed [UNNotification](http://www.mbsplugins.eu/component_UNNotification.shtml) functions to return error on server.
- **Version 7.3**
    - Added [UNNotification.AuthorizationError](http://www.mbsplugins.eu/UNNotificationAuthorizationError.shtml) and [UNNotification.AuthorizationGranted](http://www.mbsplugins.eu/UNNotificationAuthorizationGranted.shtml).

### Blog Entries

- [MBS @ FMTraining.TV - 25 Ways to Improve Your Database Using the FileMaker MonkeyBread Plug-in - Day 2](https://www.mbsplugins.de/archive/2025-01-23/MBS_@_FMTrainingTV_-_25_Ways_t/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Advent calendar - Door 17 - User Notifications](https://www.mbsplugins.de/archive/2024-12-17/MBS_FileMaker_Advent_calendar_/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 14.3 for Claris FileMaker](https://www.mbsplugins.de/archive/2024-07-09/MBS_FileMaker_Plugin_143_for_C/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 9.3 - More than 5900 Functions In One Plugin](https://www.mbsplugins.de/archive/2019-07-24/MBS_FileMaker_Plugin_93_-_More/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 9.1 - More than 5700 Functions In One Plugin](https://www.mbsplugins.de/archive/2019-03-12/MBS_FileMaker_Plugin_91_-_More/monkeybreadsoftware_blog_filemaker)
- [5000 Functions in MBS Plugin](https://www.mbsplugins.de/archive/2017-11-11/5000_Functions_in_MBS_Plugin/monkeybreadsoftware_blog_filemaker)
- [Push Notifications for FileMaker iOS SDK](https://www.mbsplugins.de/archive/2017-07-25/Push_Notifications_for_FileMak/monkeybreadsoftware_blog_filemaker)
- [Remote Notifications for FileMaker iOS SDK](https://www.mbsplugins.de/archive/2017-06-07/Remote_Notifications_for_FileM/monkeybreadsoftware_blog_filemaker)
- [Welcome FileMaker 16](https://www.mbsplugins.de/archive/2017-05-09/Welcome_FileMaker_16/monkeybreadsoftware_blog_filemaker)
- [Notifications coming for FileMaker iOS SDK](https://www.mbsplugins.de/archive/2017-04-17/Notifications_coming_for_FileM/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 4/2022, Seite 22](https://filemaker-magazin.de/neuigkeit/4191-Appetithappen-FMM_202204)

### Example Databases

- [Mac and iOS/UNNotification](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/UNNotification.shtml#1ScriptAnchor_)

[HTML Version](component_UNNotification.shtml)