snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

docs/main/end-user-guide/collaborate/message-priority.mdx

@@ -0,0 +1,60 @@
+---
+title: "Set message priority"
+---
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<PlanAvailability slug="all-commercial" />
+
+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.
+
+<img src={useBaseUrl('/images/MPA-Animated-GIF-Update-2023-08-15.gif')} width="700" alt="Ensure important and urgent messages stand out clearly by adding priority labels to root messages." />
+
+To set the priority of a new root message:
+
+1.  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.
+2.  Select the priority for the message. Messages have a standard priority by default.
+3.  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:
+
+1.  Compose a root message with at least one @mention.
+2.  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.
+3.  Select **Urgent**.
+4.  Select **Send persistent notifications**.
+5.  Select **Apply**.
+
+<Note>
+
+- @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](/administration-guide/configure/site-configuration-settings#persistent-notifications) documentation for details.
+
+</Note>
+
+## 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](/end-user-guide/preferences/manage-your-notifications) 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](/end-user-guide/preferences/set-your-status-availability#set-your-availability). Learn more about managing and customizing how you receive [Mattermost notifications](/end-user-guide/preferences/manage-your-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.
+
+![Example of the channel sidebar with both regular and urgent unread messages.](/images/urgent-message.png)
+
+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.
+
+<Tip>
+
+- 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.
+
+</Tip>