WindowsUserNotification.SetPriority
-----------------------------------

Sets the priority of the toast notification.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [WindowsUserNotification](component_WindowsUserNotification.md) | [13.1](newinversion131.md) | ❌ No | ✅ Yes | ❌ No | ❌ No | ❌ No |

MBS( "WindowsUserNotification.SetPriority"; Notification; Value ) 

**MBS**( **"WindowsUserNotification.SetPriority";** /\* Sets the priority of the toast notification. \*/  
**$Notification**; /\* The reference number for the Windows User Notification. \*/   
**$Value**) /\* The new setting.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Notification | The reference number for the Windows User Notification. | $Notification |
| Value | The new setting. | 0 |

### Result

Returns OK or error.

### Description

Sets the priority of the toast notification.  
Requires Windows 10 Creators Update (introduced in 10.0.15063.0)  
  
The priority setting provides hints on how and at what urgency level a notification should be presented to the user (whether to wake up the screen, etc). Whether the notification is displayed in high priority is based on the state and power management policy of the device.  
  
Pass 1 for high and 0 for normal.  
Value is -1 to take Windows’ default setting.  
### Examples

Set to high priority:

 Set Variable \[ $r ; Value: MBS ( "WindowsUserNotification.SetPriority"; $Notification ; 1 ) \]  
### See also

- [WindowsUserNotification.GetPriority](WindowsUserNotificationGetPriority.md)
- [WindowsUserNotification.ReleaseAll](WindowsUserNotificationReleaseAll.md)
- [WindowsUserNotification.SetFileName](WindowsUserNotificationSetFileName.md)
- [WindowsUserNotification.SetGroup](WindowsUserNotificationSetGroup.md)
- [WindowsUserNotification.SetImagePath](WindowsUserNotificationSetImagePath.md)
- [WindowsUserNotification.SetRemoteId](WindowsUserNotificationSetRemoteId.md)
- [WindowsUserNotification.SetScriptName](WindowsUserNotificationSetScriptName.md)
- [WindowsUserNotification.SetTag](WindowsUserNotificationSetTag.md)
- [WindowsUserNotification.SetText](WindowsUserNotificationSetText.md)
- [WindowsUserNotification.Setting](WindowsUserNotificationSetting.md)

### Release notes

- **Version 13.1**
    - Added [WindowsUserNotification.SetPriority](https://www.mbsplugins.eu/WindowsUserNotificationSetPriority.shtml) and [WindowsUserNotification.GetPriority](https://www.mbsplugins.eu/WindowsUserNotificationGetPriority.shtml) functions.

### Blog Entries

- [New in MBS FileMaker Plugin 13.1](https://www.mbsplugins.de/archive/2023-03-15/New_in_MBS_FileMaker_Plugin_13/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 13.1pr1](https://www.mbsplugins.de/archive/2023-02-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 21st January 2023 , last changed 20th May 2025

  
[WindowsUserNotification.SetNotificationMirroring](WindowsUserNotificationSetNotificationMirroring.md) - [WindowsUserNotification.SetRemoteId](WindowsUserNotificationSetRemoteId.md)

[HTML Version](WindowsUserNotificationSetPriority.shtml)