diff --git a/source/help/getting-started/configuring-notifications.md b/source/help/getting-started/configuring-notifications.md deleted file mode 100644 index e37df324c8c..00000000000 --- a/source/help/getting-started/configuring-notifications.md +++ /dev/null @@ -1,52 +0,0 @@ -# Configuring Notifications -_____ -Notifications in Mattermost alert you to unread messages and mentions. - -## Unreads indicated by Bold Channel Header - -The name of a channel in the left-hand sidebar shows as **bold** when there are unread messages in the channel. Clicking on the channel removes the bold indicator, and brings you to the earliest unread message in the channel. - -### Muting Unreads in a Channel - -You can choose not to show unread indicators in a channel by clicking **Channel Menu** > **Notification Preferences** > **Mark Channel Unread** and selecting **Only for mentions**. - -This will only notify you if a mention is triggered on your name or a keyword for which you're listening. - -## Mentions indicated by Mention Count - -Unread mentions or [your name or selected keywords](https://docs.mattermost.com/help/settings/account-settings.html#words-that-trigger-mentions) in a channel are indicated by bold text and a mention counter next to the channel name in the left-hand-sidebar. - -Clicking the channel name removes the bolding and mention count. You can review your recent mentions by clicking **@** next to the search box at the top of the screen. - -Learn more about [mentioning teammates](http://docs.mattermost.com/help/messaging/mentioning-teammates.html). - -## Email Notifications -Emails are sent for any mentions you receive if you have Mattermost closed or have not had any browser activity for a short time. - -- Turn email notifications On or Off in **Account Settings** > **Notifications** > **Email Notifications**. -- Configure the email address where notifications are sent in **Account Settings** > **General** > **Email** - -## Desktop Notifications -These are browser notifications that appear in the corner of your main monitor. By default, these notifications are sent for all activity while Mattermost is open. Desktop notifications are available on Firefox, Safari, and Chrome. - -- Configure when desktop notifications are sent from **Account Settings** > **Notifications** > **Desktop Notifications** > **Send Desktop Notifications**. -- Configure channel specific desktop notifications from **Channel Menu** > **Notification Preferences** > **Send Desktop Notifications**. By default, all channels use the global setting configured in *Account Settings*. - -## Mobile Push Notifications -If the Mattermost Android or iOS app is installed, push notifications can be sent to your mobile device. By default, these notifications are sent for mentions in any channel or direct message channel that is not being viewed on desktop. - -- Configure when push notifications are sent from **Account Settings** > **Notifications** > **Mobile Push Notifications** > **Send mobile push notifications**. -- Configure when push notifications are sent depending on your status from **Account Settings** > **Notifications** > **Mobile Push Notifications** > **Trigger push notifications when**. - -## Notification Sounds -A notification sound plays for all activity that would fire a desktop notification. Notification sounds are available on Safari, Chrome and Edge. - -- Turn notification sounds On or Off in **Account Settings** > **Notifications** > **Desktop Notification Sounds**. -- Configure desktop notification triggers, sounds and duration in **Account Settings** > **Notifications** > **Desktop Notifications**. -- Configure channel specific desktop notifications from **Channel Menu** > **Notification Preferences** > **Send Desktop Notifications**. By default, all channels use the global setting configured in *Account Settings*. - -## Browser Tab Notifications -The browser tab favicon updates to inform you of unread messages and mentions if Mattermost is open in an inactive browser tab. Browser tab notifications are available on Firefox and Chrome. - -- Unread messages are denoted by an asterisk (*) next to a black Mattermost icon. -- Mentions are denoted by a red Mattermost icon with the number of unread mentions shown in brackets. diff --git a/source/help/getting-started/configuring-notifications.rst b/source/help/getting-started/configuring-notifications.rst new file mode 100644 index 00000000000..a6aeeb63395 --- /dev/null +++ b/source/help/getting-started/configuring-notifications.rst @@ -0,0 +1,102 @@ +Configuring Notifications +========================= + +Notifications in Mattermost alert you to unread messages and mentions. + +Unreads and Mentions +---------------------------------------- + +Unread Messages Indicator +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The name of a channel in the left-hand sidebar shows as **bold** when +there are unread messages in the channel. Clicking on the channel +removes the bold indicator, and brings you to the earliest unread +message in the channel. + +You can choose not to show unread indicators in a channel by clicking +**Channel Menu** > **Notification Preferences** > **Mark Channel +Unread** and selecting **Only for mentions**. This will only notify you if a mention is triggered on your name or a +keyword for which you're listening. + +Mentions Indicator +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Mentions are triggered by `selected +keywords `__ +in a channel. Unread mentions are indicated by bold text and a mention counter next to +the channel name in the left-hand sidebar. + +Clicking the channel name removes the bolding and mention count. You can +review your recent mentions by clicking **@** next to the search box +at the top of the screen. + +Learn more about `mentioning +teammates `__. + +Email Notifications +------------------------------------- + +Emails are sent for any mentions you receive if you have Mattermost +closed or have not had any browser activity for a short time. + +- Turn email notifications On or Off in **Account Settings** > + **Notifications** > **Email Notifications**. +- Configure the email address where notifications are sent in **Account + Settings** > **General** > **Email**. + +Desktop Notifications +------------------------------------- + +These are browser notifications that appear in the corner of your main +monitor. By default, these notifications are sent for all activity while +Mattermost is open. Desktop notifications are available on Edge, Firefox, +Safari, Chrome and `Mattermost Desktop Apps `_. + +- Configure when desktop notifications are sent from **Account + Settings** > **Notifications** > **Desktop Notifications** > **Send + Desktop Notifications**. +- Configure channel specific desktop notifications from **Channel + Menu** > **Notification Preferences** > **Send Desktop + Notifications**. By default, all channels use the global setting + configured in *Account Settings*. + +Notification Sounds +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A notification sound plays for all activity that would fire a desktop +notification. Notification sounds are available on IE11, Edge, Safari, Chrome and +`Mattermost Desktop Apps `_. + +- Turn notification sounds On or Off in **Account Settings** > + **Notifications** > **Desktop Notification Sounds**. +- Configure desktop notification triggers, sounds and duration in + **Account Settings** > **Notifications** > **Desktop Notifications**. +- Configure channel specific desktop notifications from **Channel + Menu** > **Notification Preferences** > **Send Desktop + Notifications**. By default, all channels use the global setting + configured in *Account Settings*. + +Mobile Push Notifications +-------------------------------------------- + +If the Mattermost Android or iOS app is installed, push notifications +can be sent to your mobile device. By default, these notifications are +sent for mentions in any channel or direct message channel that is not +being viewed on desktop. + +- Configure when push notifications are sent from **Account Settings** + > **Notifications** > **Mobile Push Notifications** > **Send mobile + push notifications**. +- Configure when push notifications are sent depending on your status + from **Account Settings** > **Notifications** > **Mobile Push + Notifications** > **Trigger push notifications when**. + +Browser Tab Notifications +---------------------------------------- + +If Mattermost is open in a browser tab the favicon updates to inform you of unread messages and +mentions. Browser tab notifications are available on Firefox and Chrome. + +- Unread messages are denoted by an asterisk (\*) next to the Mattermost icon. +- Unread mentions are counted in brackets.