Set message priority
import useBaseUrl from '@docusaurus/useBaseUrl';
From Mattermost v7.7 and mobile v2.4, you can add a message priority label to root messages to make important messages requiring timely action or response more visible and less likely to be overlooked.
To set the priority of a new root message:
- Select the Message Priority <img src={useBaseUrl('/img/ui/alert-circle-outline_F05D6.svg')} alt="Mark a message as important or urgent using the Priority Message icon." className="theme-icon" /> icon in the message formatting toolbar. Select from Standard, Important, or Urgent.
- Select the priority for the message. Messages have a standard priority by default.
- Select Apply
When you send a priority message, the priority label displays next to your name in the channel, as well as the Threads view when others reply to the thread.
Send persistent notifications¶
From Mattermost v8.0, messages marked as urgent with a priority label and containing an @mention can trigger persistent notifications that repeat until the recipient acknowledges, reacts, or replies.
To enable persistent notifications for a message:
- Compose a root message with at least one @mention.
- Select the Message Priority <img src={useBaseUrl('/img/ui/alert-circle-outline_F05D6.svg')} alt="Mark a message as important or urgent using the Priority Message icon." className="theme-icon" /> icon in the message formatting toolbar.
- Select Urgent.
- Select Send persistent notifications.
- Select Apply.
- @channel, @all and @here mentions don't send persistent notifications.
- System admins can customize the maximum number of @mentions permitted, how frequently and how many persistent notifications are sent, as well as disable persistent notifications for all users, if preferred. By default, users are notified every 5 minutes for a total of 30 minutes. See the configuration documentation for details.
Receive persistent notifications¶
You must have desktop and/or mobile push notifications enabled to receive persistent notifications. How you're notified depends on your notifications preferences for desktop and mobile push notifications. You won't be notified when your availability is set to Do Not Disturb, or if you're Out of Office. Learn more about managing and customizing how you receive Mattermost notifications.
Urgent messages show a red mention badge which remains visibible until you view the message. Selecting the Acknowledge icon (when present) won't impact the urgent red mention badge.
To stop receiving persistent notifications, you can reply to the thread, select the Acknowlege icon (when present), or react to the thread with an emoji. Persistent notifications also stop if the original message is deleted, or if the maximum number of persistent notifications are sent.
Request acknowledgements¶
You can additionally request that recipients actively acknowledge the message to track that messages have been seen and actioned. By default, marking a message as Urgent priority automatically requests an acknowledgement.
When you request acknowledgement of a message, an Acknowledge <img src={useBaseUrl('/img/ui/Ack-Button-Default.svg')} alt="Select the Acknowledge button to indicate that you've read it and taken necessary action." /> button is added below the sent message. You can mark the message as acknowledged by selecting the button, and you can hover over the Acknowledged <img src={useBaseUrl('/img/ui/Ack-Button-Default.svg')} alt="Select the Acknowledge button to indicate that you've read it and taken necessary action." /> icon to review who has acknowledged the message.
- When you have push notifications enabled on mobile, you'll be notified every five minutes until you acknowledge or reply to the message.
- After acknowledging a message, you have up to five minutes to change your mind. Select the Acknowledged <img src={useBaseUrl('/img/ui/Ack-Button-Default.svg')} alt="Select the Acknowledge button to indicate that you've read it and taken necessary action." /> button again to remove your name from the list of acknowledged users.