diff --git a/source/about/mattermost-v9-changelog.md b/source/about/mattermost-v9-changelog.md index fec8d1b4224..44b8439b9b2 100644 --- a/source/about/mattermost-v9-changelog.md +++ b/source/about/mattermost-v9-changelog.md @@ -160,7 +160,7 @@ See [this walkthrough video](https://mattermost.com/video/mattermost-v9-10-chang - Pre-packaged Mattermost Copilot plugin version [v0.8.1](https://github.com/mattermost/mattermost-plugin-ai/releases/tag/v0.8.1). - Pre-packaged Calls plugin version [v0.28.2](https://github.com/mattermost/mattermost-plugin-calls/releases/tag/v0.28.2). - Re-designed the user profile popover and improved its performance. - - Added banner to prompt users to give desktop notification permissions when opening the app. + - Added banner to prompt users to allow notification permissions when opening the app in web browsers. - Increased the width of the profile picture setting to match other user settings. - Improved screen reader support for the emoji picker. - Improved the accessibility of plugin buttons in the channel header. diff --git a/source/collaborate/message-priority.rst b/source/collaborate/message-priority.rst index 650d76257f0..f4306b216ec 100644 --- a/source/collaborate/message-priority.rst +++ b/source/collaborate/message-priority.rst @@ -42,7 +42,7 @@ To enable persistent notifications for a message: Receive persistent notifications -------------------------------- -You must have desktop and/or mobile push notifications enabled to receive persistent notifications. How you're notified depends on your :doc:`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 :ref:`Out of Office `. Learn more about customizing how you receive notifications by visiting the :ref:`get notified ` documentation. +You must have desktop and/or mobile push notifications enabled to receive persistent notifications. How you're notified depends on your :doc:`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 :ref:`Out of Office `. Learn more about managing and customizing how you receive :doc:`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. diff --git a/source/images/chrome-activity-badge.png b/source/images/chrome-activity-badge.png new file mode 100644 index 00000000000..8d788b33823 Binary files /dev/null and b/source/images/chrome-activity-badge.png differ diff --git a/source/images/chrome-mention-badge.png b/source/images/chrome-mention-badge.png new file mode 100644 index 00000000000..faf7b1f9de4 Binary files /dev/null and b/source/images/chrome-mention-badge.png differ diff --git a/source/images/enable-notifications.png b/source/images/enable-notifications.png new file mode 100644 index 00000000000..2450ff07bba Binary files /dev/null and b/source/images/enable-notifications.png differ diff --git a/source/images/server-logout-indicator.png b/source/images/server-logout-indicator.png new file mode 100644 index 00000000000..331dc6c8c18 Binary files /dev/null and b/source/images/server-logout-indicator.png differ diff --git a/source/images/web-notification-prompt.png b/source/images/web-notification-prompt.png new file mode 100644 index 00000000000..9cfa2e2bb8f Binary files /dev/null and b/source/images/web-notification-prompt.png differ diff --git a/source/preferences/manage-your-channel-specific-notifications.rst b/source/preferences/manage-your-channel-specific-notifications.rst new file mode 100644 index 00000000000..862f685273d --- /dev/null +++ b/source/preferences/manage-your-channel-specific-notifications.rst @@ -0,0 +1,73 @@ +Manage your channel-specific notifications +=========================================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +By default, your web and desktop notification preferences apply to all channels you’re a member of. You can customize your per-channel notification preferences for any channel you're a member of for the following actions: + +- `Mute channels <#mute-channels>`__ +- `Ignore channel-wide @mentions <#ignore-channel-wide-@mentions>`__ +- `Auto-follow all new threads <#auto-follow-all-new-channel-threads>`__ + +.. tab:: Web/Desktop + + You have 2 ways to manage notification preferences per channel: + + 1. Select the channel name, then select **Notification Preferences** from the drop-down list. + + .. image:: ../images/channel-notification-settings.gif + :alt: Select the channel name dropdown to access channel-specific notification preferences. + + 2. Alternatively, select the channel's **View Info** |channel-info| icon, and then select **Notification Preferences** in the right pane. + +.. tab:: Mobile + + Tap the channel name, and then tap **Mobile Notifications**. + +Mute channels +------------- + +All channels are unmuted by default, including direct and group messages, as well as private and public channels. + +You can choose to mute or unmute a channel at any time as follows: + +- Select **Mute Conversation** or **Unmute Conversation** for direct and group messages. +- Select **Mute Channel** or **Unmute Channel** for private and public channels. + +Once a channel is muted: + +- All notifications for that channel are disabled, including email, desktop, incoming call ring tones, and push notifications. +- The muted channel displays a mute icon next to the channel name. +- The channel is greyed out in the channel sidebar, and doesn't appear bold to indicate unread messages unless you’re :doc:`@mentioned ` in that channel directly. + +Ignore channel-wide @mentions +------------------------------ + +By default, you're notified every time someone uses channel-wide :doc:`@mentions ` including :ref:`@channel and @all `, as well as :ref:`@here `. + +When you choose to ignore channel-wide @mentions in channels, the channel name is bolded in the channel sidebar for new unreads unless it's muted. + +Follow all new channel threads +------------------------------- + +By default, you don’t automatically follow new conversation threads in any channel unless you start a thread or reply to a thread, follow a thread, or are @mentioned in a thread. + +You can configure Mattermost to automatically follow every thread in a channel. + +.. tab:: Web/Desktop + + 1. Select the channel name to access more channel options. + 2. Select **Notification Preferences**. + 3. Under **Follow all threads in this channel**, select **Automatically follow threads in this channel**. + 4. Select **Save**. + + Select **Threads** in the channel sidebar to access all threads you're following, and to unfollow threads you no longer want to follow. + +.. tab:: Mobile + + 1. In a channel, tap the **More** icon |more-icon| to the right of the channel name. + 2. Tap **View info**. + 3. Tap **Follow all threads**. + + Tap **Threads** in the channel list to access all threads you're following, and to unfollow threads you no longer want to follow. \ No newline at end of file diff --git a/source/preferences/manage-your-desktop-notifications.rst b/source/preferences/manage-your-desktop-notifications.rst new file mode 100644 index 00000000000..0f8576eb58d --- /dev/null +++ b/source/preferences/manage-your-desktop-notifications.rst @@ -0,0 +1,91 @@ +Manage your desktop notifications +================================= + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +.. |dot-badge| image:: ../images/dot-badge.png + :alt: A dot on the badge means you have unread activity in at least one channel you're a member of. + :width: 50px + +.. |numbered-badge| image:: ../images/numbered-badge.png + :alt: A numbered badge means you have at least 1 unread message, @mention, or one of your keywords has triggered a notification. + :width: 50px + +Enable notifications +-------------------- + +From Mattermost v9.9 and desktop app v5.5, Mattermost prompts you to enable notifications in the desktop app the first time you connect to a Mattermost server. + +- When you select **Allow**, you won't be asked again. You'll start receiving notifications in the desktop app for all Mattermost activity with `badges <#badge-based-notifications>`__, `banner alerts <#banner-alerts>`__ and `sounds <#notification-sounds>`__. See the section below on `customizing your notifications <#customize-your-notifications>`__ based on how you prefer to be notified about Mattermost activity in the desktop app. +- If you select **Deny** or **Deny Permanently**, you won't be asked again. You won't receive Mattermost notifications in the web browser. You can change this preference by :ref:`editing the server connection ` to :ref:`manage your notification permissions `. + +.. note:: + + - You may also need to enable notifications in Windows, macOS, or Linux for Mattermost by changing your System Preferences. + - When you allow desktop notifications, you'll also receive a second prompt asking you to allow notifications in your default web browser. + + .. image:: ../images/web-notification-prompt.png + :alt: An example of a Firefox web browser notification prompt. + :scale: 70 + +Badge-based notifications +------------------------- + +Mattermost desktop app icons display the following types of badges: + +- A numbered badge for unread :ref:`direct ` :ref:`group ` messages, :doc:`@mentions `, and :doc:`keywords ` you're actively watching. |numbered-badge| +- A dot badge for unread activity. |dot-badge| + +Banner alerts +------------- + +Banner alerts in the desktop app are popup windows that display for a limited time in the top right corner of your screen that summarizes the new activity. + +Notification sounds +-------------------- + +By default, desktop app notifications include audible sounds. + +Customize your notifications +---------------------------- + +By default, you are notified when you're @mentioned, when you receive a direct or group message, or for matches to keywords you're following. + +Want to receive notifications about replies to threads you’re following? Select **Notify me about replies to threads I’m following**. + +Want notifications for all new messages? Select **Desktop and mobile notifications > All new messages** + +Desktop app users can also :doc:`customize their desktop app experience ` further based on their platform operating system. + +Change or disable sounds +~~~~~~~~~~~~~~~~~~~~~~~~ + +You can change or disable notification sounds by going to **Desktop notification sounds > Message notification sound**. + +Incoming Call notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Want to hear a sound when a Mattermost call starts? If your Mattermost admin :ref:`enables this Beta feature `, you can choose the sound that plays when a call is started within a direct or group message by going to **Desktop notification sounds > Incoming call sound**. + +Disable all desktop notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Select **Desktop and mobile notifications > Nothing** to disable all desktop and :doc:`web notifications `. + +Clear the **Use different settings for my mobile devices** to additionally disable all Mattermost mobile notifications everywhere you use Mattermost. + +Additionally, macOS users can disable notifications for all unread activity in the desktop app by :doc:`customizing your desktop app experience ` to disable the **Show red badge on Dock icon to indicate unread messages** option. + +Frequently asked questions +--------------------------- + +What does a Mattermost icon with an exclamation point mean? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. image:: ../images/server-logout-indicator.png + :alt: A Mattermost logo with an exclamation point means you're logged out of at least 1 Mattermost server you connect to using the desktop app. + +A Mattermost icon with an exclamation point means that you're logged out of at least 1 Mattermost server you connect to using the desktop app. Log back in to any servers as needed. See the :doc:`Connect to multiple workspaces ` documentation for details. + +If the icon continues to display, refresh the **Playbooks** and/or **Boards** tabs located at the top of the desktop app window. \ No newline at end of file diff --git a/source/preferences/manage-your-mentions-keywords-notifications.rst b/source/preferences/manage-your-mentions-keywords-notifications.rst new file mode 100644 index 00000000000..0549cf26897 --- /dev/null +++ b/source/preferences/manage-your-mentions-keywords-notifications.rst @@ -0,0 +1,38 @@ +Manage your @mention and keyword notifications +============================================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +You're :doc:`notified ` in a :doc:`web browser `, the :doc:`desktop app `, and on your :doc:`mobile device `, when you're @mentioned by your username or first name, @mentioned as part of a user group, and for matches to keywords you're following. + +You're also notified when someone uses channel-wide :doc:`@mentions ` including :ref:`@channel and @all `, as well as :ref:`@here `. + +For all other messages, channels appear bolded to indicate unread activity. + +Customize notification keywords +-------------------------------- + +Using a web browser or the desktop app, you can customize keywords to trigger notifications. Keywords aren't case-sensitive. + +For example, you can receive notifications for all messages and threads related to a specific topic, project name, or customer. + +.. image:: ../images/keywords-trigger-mentions.gif + :alt: A walkthrough of setting keywords that trigger mentions in Mattermost. + +.. tip:: + + Separate multiple keywords using commas or by pressing :kbd:`Tab`, and use :kbd:`Backspace` to manage keywords. + +Passively track keywords (no notification) +------------------------------------------ + +.. include:: ../_static/badges/ent-pro-only.rst + :start-after: :nosearch: + +From Mattermost v9.3, Mattermost Enterprise and Professional customers interested calling attention to specific topics of interest across channels can do so without sending notifications to a Mattermost client. + +Using a web browser or the desktop app, you can passively track key terms by specifying single or multiple words to be highlighted in all channels you're a member of. Keywords and phrases are automatically highlighted using a color based on your :doc:`Mattermost theme `. + +.. image:: ../images/keywords-highlighted.gif + :alt: A walkthrough of setting keywords that are highlighted in Mattermost. \ No newline at end of file diff --git a/source/preferences/manage-your-mobile-notifications.rst b/source/preferences/manage-your-mobile-notifications.rst new file mode 100644 index 00000000000..e41f5378884 --- /dev/null +++ b/source/preferences/manage-your-mobile-notifications.rst @@ -0,0 +1,97 @@ +Manage your mobile notifications +================================= + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +.. |numbered-badge| image:: ../images/numbered-badge.png + :alt: A numbered badge means you have at least 1 unread message, @mention, or one of your keywords has triggered a notification. + :width: 50px + +Enable notifications +-------------------- + +From Mattermost v9.9, Mattermost prompts you to enable notifications in the mobile app the first time you open the app. + +When you enable notifications, you'll start receiving notifications for all Mattermost activity with `badges <#badge-based-notifications>`__, and `push notifications <#push-notifications>`__. See the section below on `customizing your notifications <#customize-your-notifications>`__ based on how you prefer to be notified about Mattermost activity on your mobile device. + +.. note:: + + You may also need to enable notifications in iOS or Android for Mattermost by changing your device preferences. + +Badge-based notifications +------------------------- + +Mattermost mobile app icons display numbered badges for unread :ref:`direct ` and :ref:`group ` messages, and :doc:`@mentions `, :doc:`keywords ` you're actively watching. + +|numbered-badge| + +.. note:: + + - The Mattermost mobile app doesn't display dot badges indicating other unread activity by design. The activity you're directly involved in is prioritized over other activity. + - Android users may see Mattermost notifications in the Android Notification Shade while the Mattermost icon shows no badge. This is because the Android notification system may also display badges unread activity. + +Push notifications +------------------ + +You'll see mobile push notification messages on your device as follows: + +- **iOS**: On the Lock Screen, Notification Center, and as Banners/Alerts based on your iOS settings. +- **Android**: On the Lock Screen, Notification Shade, and as Banners/Heads-Up Notifications based on your Android settings. + +Customize your notifications +---------------------------- + +You can manage your mobile notifications in both the desktop app and the mobile app. + +Desktop app +~~~~~~~~~~~~ + +In the desktop app, manage your mobile notification preferences by selecting the **Settings** |gear| icon located in the top right corner of the screen, and select **Notifications > Desktop and mobile notifications**. + +By default, you receive mobile notifications when your Mattermost availability is :ref:`away or offline `. + +- Want to receive mobile notifications when you're online too? Under **Trigger mobile notifications when I am**, select **Online, away, or offline**. Note that you won't be notified on your device if you're actively using Mattermost in a web browser. Alternatively, select **Offline** to receive fewer mobile notifications. + +- Want different desktop and mobile notifications? Select **Use different settings for my mobile devices**, and then select **All new messages**, or **Mentions, direct messages and group messages**. + +Mobile app +~~~~~~~~~~ + +In the mobile app, tap your profile picture, then tap **Settings > Notifications**. + +- Tap **Mentions** to disable notifications based on keywords that trigger mentions, including first name, username, channel-wide @mentions, and keywords you've specified. +- Tap **Push Notifications** to choose what to be notified about. + +You can also :ref:`manage email notifications ` and :ref:`send automatic replies to direct messages ` directly from your device. + +Incoming Call notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Want to hear a sound on your mobile device when a Mattermost call starts? If your Mattermost admin :ref:`enables this Beta feature `, select **Call Notifications** to choose the sound that plays when a call is started within a direct or group message you're participating in. + +.. tip:: + + - From Mattermost mobile app v2.19, incoming call sounds also include device vibration, as well as vibration-only when your device is in silent mode. + - If you prefer a separate call sound on mobile, your mobile change applies only to your mobile device. + +Disable all mobile notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +To disable all Mattermost mobile notifications, tap **Push Notifications > Nothing**. + +Frequently asked questions +-------------------------- + +Are mobile notification counts the same as other Mattermost clients? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +No. You're only notified of unread threads with @mentions on your mobile device. You're not notified of general unread activity on mobile. + +What does a Mattermost icon with an exclamation point mean? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. image:: ../images/server-logout-indicator.png + :alt: A Mattermost logo with an exclamation point means you're logged out of at least 1 Mattermost server you connect to using the mobile app. + +A Mattermost icon with an exclamation point means that you're logged out of at least 1 Mattermost server you connect to using the mobile app. Log back in to any servers as needed. See the :doc:`Connect to multiple workspaces ` documentation for details. \ No newline at end of file diff --git a/source/preferences/manage-your-notifications.rst b/source/preferences/manage-your-notifications.rst index 76136843984..48b402476e6 100644 --- a/source/preferences/manage-your-notifications.rst +++ b/source/preferences/manage-your-notifications.rst @@ -5,169 +5,84 @@ Manage your notifications :start-after: :nosearch: .. |dot-badge| image:: ../images/dot-badge.png - :alt: A dot on the badge means you have unread activity in at least one channel you're a member of. - :width: 50px - + :alt: A dot on the badge means you have unread activity in at least one channel you're a member of. + :width: 50px .. |numbered-badge| image:: ../images/numbered-badge.png - :alt: A numbered badge means you have at least 1 unread message, @mention, or one of your keywords has triggered a notification. - :width: 50px - -Mattermost notifies you of new activity in the following ways: - -**Badges**: In Mattermost, badges show you when you have unread messages and threads. - - |dot-badge| You have unread activity in at least one channel you're a member of. + :alt: A numbered badge means you have at least 1 unread message, @mention, or one of your keywords has triggered a notification. + :width: 50px - |numbered-badge| You have at least one unread :ref:`direct message `, :ref:`group message `, :doc:`@mention `, or a keyword triggered a notification. +.. toctree:: + :maxdepth: 1 + :hidden: + :titlesonly: -**Banner alerts**: Pop-ups alert you to new activity. + Manage your web notifications + Manage your desktop notifications + Manage your mobile notifications + Manage your thread reply notifications + Manage your @mention & keyword notifications + Manage your channel-specific notifications -**Push notifications**: Mobile app alert you to new activity when you're on the go. - -**Sounds**: Audible sounds alert you to new activity. +Mattermost notifies you of new activity you're directly involved in. How you're notified depends on what Mattermost client you're using, the type of Mattermost activity you're being notified about, and how you prefer to be notified. .. include:: ../_static/badges/academy-notifications.rst :start-after: :nosearch: -Get notified -------------- +You're in control +------------------ -You can configure Mattermost to receive increase or decrease the number of notifications based on your preferences. +You are in control of how, when, and where you're notified of activity that matters to you based on how you prefer to work and collaborate. To access notification preferences: -In a web browser or the desktop app, select the **Settings** |gear| icon located in the top right corner of the screen to manage your notification preferences. +- In a web browser or the desktop app, select the **Settings** |gear| icon located in the top right corner of the screen to manage your notification preferences. +- On mobile, tap your profile picture, then tap **Settings > Notifications**. -On mobile, select the **Settings** |gear| icon and tap **Notifications**. +See the `Default notifications <#default-notifications>`__ table below for details on customizing your notification experience based on your preferred Mattermost client. .. tip:: - - From Mattermost v9.8, your desktop and mobile notification preferences have been combined together under **Settings > Notifications**. If you're using an older Mattermost release, you'll find these settings split out as desktop settings and mobile settings instead. - - Missing notifications? Visit our `notifications knowledge base article `__ for additional troubleshooting tips and tricks. - -.. tab:: Web/Desktop/Mobile - - By default, you're notified of all Mattermost activity in Mattermost with badges, banner alerts, and sounds, regardless of how you access Mattermost, and your current :ref:`Mattermost availability `. - - When accessing Mattermost using a supported web browser, the browser tab's favicon notifies you of unread messages with an asterisk (*) and a message count. From Mattermost v9.9, you're prompted to give Mattermost permission to send you notifications in the announcement bar. - - - When you select **Enable notifications**, you won't be asked again, and you'll start receiving Mattermost notifications in the web browser. - - If you dismiss the prompt, you won't receive notifications in the web browser, and you'll prompted again the next time you open Mattermost in a browser. - - **Want different notifications on mobile?** - - To personalize your notification preferences for the mobile app, select **Desktop and mobile notifications**, and then select **Use different settings for my mobile devices** to define how mobile notifications are triggered, when they're triggered based on you being online, away, or offline, and whether they include replies to threads you're following. - - **Getting too many notifications?** - - If you're receiving too many notifications, you can configure Mattermost to notify you for select messages only. Select **Desktop and mobile notifications > Mentions, direct messages, and group messages** to receive notifications for mentions, direct messages, and group messages only. This option also enables you to receive notifications about replies to threads you're following by selecting **Notify me about replies to threads I'm following**. - - Disable web, desktop, and mobile notifications altogether by selecting **Desktop and mobile notifications > Nothing**. - -.. tab:: Notification sounds - - By default, desktop message notifications include audible sounds. You can change or disable these sounds if preferred. Go to **Desktop notification sounds > Message notification sound** to choose a different sound, or disable this option to turn off desktop notification sounds, if preferred. - - **Want incoming call sounds?** - - Want to hear a sound when a Mattermost call starts? If your Mattermost admin :ref:`enables this Beta feature `, you can choose the sound that plays when a call is started within a direct or group message you're participating in by going to **Desktop notifications > Notification sound for incoming calls**. - - From Mattermost mobile app v2.19, incoming call sounds on mobile include sounds and vibration, and vibration only when your device is in silent mode. You can set one **Incoming call sound** for web or desktop, and a different one for mobile. When you select an **Incoming call sound** on mobile, your changes apply only to mobile. - -.. tab:: Email - - By default, you're notified of all Mattermost activity by email right away when you're offline or away from Mattermost for more than 5 minutes. - - **Too many notifications?** - - Turn off email notifications altogether by selecting **Email Notifications > Never**. - - **Group email notifications in batches** - - Mattermost also supports the ability to group multiple email notifications together into a single email. If your Mattermost admin :ref:`enables this feature `, you'll receive batches of notifications by email every 15 minutes, or as configured by your admin. - -.. tab:: @mentions & keywords - - By default, you’re notified when you’re @mentioned in a message or a thread by your username or first name, or when a thread you’re following has a new response. For all other messages, the channel is highlighted to indicate unread messages. - - You're also notified when someone uses channel-wide :doc:`mentions ` including @channel, @all, and @here. - - **Customize notification keywords** - - Using a web browser or the desktop app, customize any additional non case-sensitive keywords to trigger notifications. For example, you can receive notifications for all messages and threads related to a specific topic, project name, or customer. Separate multiple keywords using commas or by pressing :kbd:`Tab`, and use :kbd:`Backspace` to manage keywords. - - .. image:: ../images/keywords-trigger-mentions.gif - :alt: A walkthrough of setting keywords that trigger mentions in Mattermost. - - **Passively track keywords (no notification)** - - .. include:: ../_static/badges/ent-pro-only.rst - :start-after: :nosearch: - - From Mattermost v9.3, Mattermost Enterprise and Professional users interested calling attention to specific topics of interest across channels, at a glance, can do so without triggering notifications. - - Using a web browser or the desktop app, passively track key terms by specifying single or multi-words to highlight in all channels you're a member of. Keywords and phrases are automatically highlighted based on your :doc:`Mattermost theme `. - - .. image:: ../images/keywords-highlighted.gif - :alt: A walkthrough of setting keywords that are highlighted in Mattermost. - -.. tab:: Replies - - If :doc:`Threaded discussions ` are disabled, you won't be notified in reply threads unless you're @mentioned. However, you can configure Mattermost to notify you when someone replies to a thread you started, or started or have participated in. Select **Reply notifications** to choose the option that works best for you. This setting is hidden when Threaded discussions is enabled. - - **Automatic replies** - - Mattermost also supports the ability to automatically send custom replies to direct messages. If your Mattermost admin enables this experimental feature, you can go to **Automatic Direct Message Replies** to select **Enable** this feature and compose your message. - -.. tab:: Per-channel - - You can set notification preferences at the channel level, including group messages, for every channel you're a member of. You have 2 ways to access channel preferences: - - Select the channel name, then select **Notification Preferences**. - - .. image:: ../images/channel-notification-settings.gif - :alt: Select the channel name dropdown to access channel-specific notification preferences. - - Alternatively, select the channel's **View Info** |channel-info| icon, and then select **Notification Preferences** in the right pane. - - **Mute channel** - - All channels are unmuted by default. Using Mattermost in a web browser or the desktop app, mute a channel any time by selecting **Mute Channel**. Mute a direct message or group message by selecting **Mute Conversation**. You can unmute channels the same way by selecting **Unmute Channel** and **Unmute Conversation**. - - Using the mobile app: - - 1. Tap the channel or conversation you want to mute. - 2. Tap the **More** |more-icon| icon located in the top right corner of the app. - 3. Tap **Mute**. - 4. Unmute the channel or conversation by tapping **Mute** again. - - Once a channel is muted: - - - Email, desktop, incoming call ring tones, and push notifications are disabled. - - A mute icon displays next to the channel, direct message, or group message’s name. - - The channel is dimmed in the channel sidebar, and isn’t bolded to indicate unread messages unless you’re :doc:`@mentioned ` directly. - - **Ignore channel-wide @mentions** - - By default, you’ll be notified every time someone on your team mentions an entire channel using @channel, @all, or @here. - - When using Mattermost in a web browser or the desktop app, stop being notified for channel-wide @mentions, by selecting the **Ignore mentions for @channel, @here and @all** option. Mention notifications for channel-wide mentions are ignored, but the channel is marked as unread unless it's muted. + From Mattermost v9.8, your desktop and mobile notification preferences have been combined together under **Notifications**. If you're using an older Mattermost release and older Mattermost clients, you'll find separate preferences for desktop and mobile. - - In the desktop app, your mobile push notification preferences use the same configuration as the desktop app by default. Clear the **Use the same notification setting as desktop** option to customize your push notification preferences. You can receive notifications for all new messages; mentions, direct messages, and keywords; or no notifications within the desktop app. +Default notifications +------------------------ - - In the mobile app, you're notified about all new messages by default. You can customize your mobile app notification preferences. You can receive notifications for all new messages, mentions only, or no notifications. +Mattermost notifies you of new activity, including unread activity, :ref:`direct ` and :ref:`group ` messages, and :doc:`@mentions `, :doc:`keywords ` you're actively watching, :doc:`thread replies `, and unread activity in :doc:`specific channels `. - - Select **Reset to default** to return to global defaults. +The table below lists the types of notifications you can expect to see and hear in Mattermost. Select your preferred Mattermost clients to learn more about notifications for that client. - **Desktop notifications** ++-----------------------+---------------------------------------------------+-------------------------------------------------------------------+ +| **Notification Type** | **What it Means** | **Which Mattermost Clients?** | ++=======================+===================================================+===================================================================+ +| Icon badge (dot) | You have unread activity in at least 1 channel | :doc:`Web `, | +| | you're a member of | :doc:`Desktop ` | +| |dot-badge| | | | ++-----------------------+---------------------------------------------------+-------------------------------------------------------------------+ +| Icon badge (number) | You have at least 1 unread message with an | :doc:`Web ` & | +| | @mention, or a match to a keyword you're watching | :doc:`Desktop ` | +| |numbered-badge| | | & :doc:`Mobile ` | ++-----------------------+ +-------------------------------------------------------------------+ +| Banner alert popups | | :doc:`Web ` & | +| | | :doc:`Desktop ` | ++-----------------------+ +-------------------------------------------------------------------+ +| Push notifications | | :doc:`Mobile ` | +| | | | ++-----------------------+---------------------------------------------------+-------------------------------------------------------------------+ +| Alert sounds | You have at least 1 unread message with an | :doc:`Web `, | +| | @mention, a match to a keyword you're watching, | :doc:`Desktop `, | +| | or replies to a thread you're following | & :doc:`Mobile ` | ++-----------------------+---------------------------------------------------+-------------------------------------------------------------------+ - By default, your web and desktop notification preferences apply to all channels you’re a member of. You can customize notifications on a channel by channel basis if preferred by selecting **Desktop notifications**. Select **(Default**) options to revert back to your global preferences. +Email notifications +~~~~~~~~~~~~~~~~~~~~ - **Mobile push notifications** +By default, Mattermost notifications are sent to you via email for :doc:`@mentions ` and :ref:`direct messages ` when you are :ref:`offline or away ` from Mattermost for more than 5 minutes. - By default, your mobile push notification preferences apply to all channels you’re a member of. You can customize notifications on a channel by channel basis if preferred by selecting **Mobile push notifications**. Select **(Default**) options to revert back to your global preferences. +You can disable email notifications by going to **Settings > Notifications > Email notifications** and changing **Immediately** to **Never**. - **Auto-follow all new threads in this channel** +.. note:: - By default, you don’t automatically follow new conversation threads unless you start a thread or reply to a thread, follow a thread, or are @mentioned in a thread. + Mattermost can group multiple email notifications together into a single email. If your Mattermost admin :ref:`enables this feature `, you'll receive batches of notifications by email every 15 minutes, or as configured by your admin. - You can configure Mattermost to automatically follow every thread in a channel. When enabled, you can access all threads in the **Threads** view, and unfollow individual threads as you prefer. +Missing notifications? +---------------------- +Visit the Mattermost `notifications Knowledge Base article `__ for additional troubleshooting tips and tricks. \ No newline at end of file diff --git a/source/preferences/manage-your-thread-reply-notifications.rst b/source/preferences/manage-your-thread-reply-notifications.rst new file mode 100644 index 00000000000..c5e570beaaf --- /dev/null +++ b/source/preferences/manage-your-thread-reply-notifications.rst @@ -0,0 +1,48 @@ +Manage your thread reply notifications +====================================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +You're :doc:`notified ` in a :doc:`web browser `, the :doc:`desktop app `, and on your :doc:`mobile device `, for threads you're following when you're @mentioned or the messages contain a keyword you're tracking. + +.. tip:: + + - Mattermost auto-follows you on all direct and group messages, any thread you start, as well as any thread where you've been :doc:`@mentioned ` directly. + - You can choose to :ref:`follow or unfollow any thread ` at any time. + +You won't receive notifications for threads you're not following, or thread replies when they don't @mention you directly. However, blue message indicators show you unread thread replies you're not following in a given public or private channel. + +For all other messages, a channel appears bolded to indicate unread messages. + +Customize your notifications +---------------------------- + +Follow all threads in channels automatically +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can follow all threads in a channel automatically by going to **Channel Settings > Notification Preferences > Follow all threads in this channel and enable the Automatically follow threads in this channel**. + +Get notified when threaded discussions are disabled +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If your organization doesn't use threaded discussions, or you have :ref:`opted out of threaded discussions `, you can configure Mattermost to notify you when someone replies to a thread you started, or have participated in. Go to **Settings > Notifications > Reply notifications** to choose one of 3 options: + +- Receive notifications for messages in reply threads that you either start or participate in. +- Receive notifications on messages, but only in threads that you start. +- Don't receive notifications on messages in reply threads unless you're directly @mentioned. + +Send automatic replies to direct messages +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Want to automatically reply to direct messages when you're out of office? When your system admin :ref:`enables the ability for you to do so `, you can configure Mattermost to send custom replies to direct messages by going to **Settings > Notifications > Automatic Direct Message Replies**, selecting **Enable**, and composing your automatic reply message. + +Frequently asked questions +-------------------------- + +Are thread notification counts the same across all Mattermost clients? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +No. Mobile app notifications only indicate unread threads with @mentions, and not general unread activity. + +Using Mattermost in a web browser or the desktop app, the **Threads** list bolds unread threads that don't contain @mentions. \ No newline at end of file diff --git a/source/preferences/manage-your-web-notifications.rst b/source/preferences/manage-your-web-notifications.rst new file mode 100644 index 00000000000..2932f4119be --- /dev/null +++ b/source/preferences/manage-your-web-notifications.rst @@ -0,0 +1,77 @@ +Manage your web notifications +============================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +.. |chrome-mention-badge| image:: ../images/chrome-mention-badge.png + :alt: An example of a Chrome web browser mention badge indicator. + +.. |chrome-activity-badge| image:: ../images/chrome-activity-badge.png + :alt: An example of a Chrome web browser activity badge indicator. + +Enable notifications +-------------------- + +From Mattermost v9.10, Mattermost prompts you to enable notifications in your web browser. + +.. image:: ../images/enable-notifications.png + :alt: From Mattermost v9.10, you're prompted to enable notifications. + +- When you select **Enable notifications**, you won't be asked again. You'll start receiving notifications in your web browser for all Mattermost activity with `badges <#badge-based-notifications>`__ and `sounds <#notification-sounds>`__. See the section below on `customizing your notifications <#customize-your-notifications>`__ based on how you prefer to be notified about Mattermost activity in a web browser. +- If you dismiss this prompt, you won't receive Mattermost notifications in the web browser, and you'll prompted again the next time you open Mattermost in a web browser. + +Badge-based notifications +------------------------- + +In a web browser, Mattermost icons display the following types of badges: + +- Numbered badges for unread :ref:`direct ` :ref:`group ` messages, :doc:`@mentions `, and :doc:`keywords ` you're actively watching. + + - A red dot badge means an unread @mention or keyword. |chrome-mention-badge| + + - A black dot badge means an unread direct or group message. |chrome-activity-badge| + +Notification sounds +-------------------- + +By default, web-based notifications include audible sounds. + +Customize your notifications +---------------------------- + +.. tip:: + + Mattermost notification settings labeled as Desktop also configure your web-based notifications when using Mattermost in a web browser. + +Reduce web notifications +~~~~~~~~~~~~~~~~~~~~~~~~~ + +To reduce the number of notifications you receive, select **Desktop and mobile notifications > Mentions, direct messages, and group messages**, and save your changes. + +With limited notifications enabled, you can also choose to receive notifications about replies to threads you're following by selecting **Notify me about replies to threads I'm following**. + +Change or disable sounds +~~~~~~~~~~~~~~~~~~~~~~~~ + +You can change or disable notification sounds by going to **Desktop notification sounds > Message notification sound**. + +Incoming Call notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Want to hear a sound when a Mattermost call starts? If your Mattermost admin :ref:`enables this Beta feature `, you can choose the sound that plays when a call is started within a direct or group message by going to **Desktop notification sounds > Incoming call sound**. + +Disable all web notifications +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Select **Desktop and mobile notifications > Nothing** to disable all web and desktop notifications. + +Clear the **Use different settings for my mobile devices** to additionally disable all Mattermost mobile notifications everywhere you use Mattermost. + +Frequently asked questions +-------------------------- + +Why am I prompted repeatedly enable notifications I don't want? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Mattermost will continue to prompt you to enable notifications in a web browser until you respond to the prompt. If you want to disable all Mattermost notifications, select **Enable notifications** when prompted, and then `disable all Mattermost web notifications <#disable-all-web-notifications>`__. \ No newline at end of file