diff --git a/source/_static/css/mattermost-global.css b/source/_static/css/mattermost-global.css index f1ae7e9c9ce..03831891d1a 100644 --- a/source/_static/css/mattermost-global.css +++ b/source/_static/css/mattermost-global.css @@ -1999,3 +1999,9 @@ mark { .mermaid text#task20-text { fill: white !important; } + +/* NESTED TABS */ +#check-your-mattermost-client-settings .tab-set .tab-set { + background-color: var(--color-background-secondary); + padding: 0rem 1rem 1rem 1rem; +} \ No newline at end of file diff --git a/source/images/desktop-notification-check.gif b/source/images/desktop-notification-check.gif new file mode 100644 index 00000000000..0275e866420 Binary files /dev/null and b/source/images/desktop-notification-check.gif differ diff --git a/source/images/desktop-server-notification-check.gif b/source/images/desktop-server-notification-check.gif new file mode 100644 index 00000000000..82648bc438e Binary files /dev/null and b/source/images/desktop-server-notification-check.gif differ diff --git a/source/preferences/manage-your-notifications.rst b/source/preferences/manage-your-notifications.rst index 48b402476e6..298afcdefbe 100644 --- a/source/preferences/manage-your-notifications.rst +++ b/source/preferences/manage-your-notifications.rst @@ -16,6 +16,7 @@ Manage your notifications :hidden: :titlesonly: + Troubleshoot notifications Manage your web notifications Manage your desktop notifications Manage your mobile notifications @@ -28,6 +29,8 @@ Mattermost notifies you of new activity you're directly involved in. How you're .. include:: ../_static/badges/academy-notifications.rst :start-after: :nosearch: +Missing notifications? Visit our :doc:`troubleshoot notifications ` documentation for guidance on ensuring notification delivery. + You're in control ------------------ diff --git a/source/preferences/troubleshoot-notifications.rst b/source/preferences/troubleshoot-notifications.rst new file mode 100644 index 00000000000..63a28cb5f01 --- /dev/null +++ b/source/preferences/troubleshoot-notifications.rst @@ -0,0 +1,157 @@ +Troubleshoot notifications +========================== + +.. include:: ../_static/badges/allplans-cloud-selfhosted.rst + :start-after: :nosearch: + +The Mattermost notifications you receive depend on your `Mattermost preferences <#check-your-mattermost-preferences>`__, the `Mattermost client <#check-your-mattermost-client-settings>`__ you're using, and the `operating system (OS) <#check-your-operating-system-settings>`__ you're running Mattermost on. + +If you’re having trouble receiving Mattermost notifications, see the following sections for troubleshooting steps you can follow to ensure you're receiving the notifications you want. + +Check your Mattermost preferences +---------------------------------- + +Start by ensuring that your Mattermost preferences have notifications enabled. + +.. tab:: Desktop + + 1. Select **Settings** |gear| in the top right corner of Mattermost. + 2. Select **Desktop and mobile notifications**. + + If **Send notifications for** is set to **Nothing**, then Mattermost notifications are currently disabled. Select either the **All new messages** or **Mentions, direct messages, and group messages** option instead, and save your changes. + + .. image:: ../images/desktop-notification-check.gif + :alt: Select the Gear icon to enable Mattermost notifications. + +.. tab:: Web + + 1. Select **Settings** |gear| in the top right corner of Mattermost. + 2. Select **Desktop and mobile notifications**. + + If **Send notifications for** is set to **Nothing**, then Mattermost notifications are currently disabled. Select either the **All new messages** or **Mentions, direct messages, and group messages** option instead. + +.. tab:: Mobile + + 1. Tap on your profile picture in the bottom right corner of Mattermost. + 2. Tap **Settings** |gear|. + 3. Tap **Notifications**. + 4. Tap **Push Notifications**. + 5. Ensure that **All new messages** or **Mentions, direct messages, and group messages** option is selected. + 6. Under **Trigger push notifications when…**, select **Online, away or offline** to always receive notifications. + +We recommend checking your Mattermost client settings next. + +Check your Mattermost client settings +------------------------------------- + +.. tab:: Desktop + + Ensure notifications are enabled in your Mattermost server connection. + + 1. Select the Mattermost Server option in the top left of the desktop app, then edit the server details. + 2. Under **Permissions**, enable **Notifications** and save your changes. + + .. image:: ../images/desktop-server-notification-check.gif + :alt: Select the server option to enable Mattermost notifications. + +.. tab:: Web + + If you prefer to use Mattermost in a web browser, you must grant notification permissions for Mattermost in the web browser. If you don't, the web browser can block you from receiving Mattermost notifications. + + Select the **Chrome**, **Edge**, **Firefox**, or **Safari** tab below based on your preferred web browser: + + .. tab:: Chrome + + Grant notification permissions for Mattermost in your Chrome web browser. + + 1. From the Chrome menu, select **Settings**. + 2. Select **Privacy and Security** in the left pane. + 3. Expand **Site settings**. + 4. Under **Permissions**, expand **Notifications**. + 5. Enable the **Sites can ask to send notifications** option, and add your Mattermost workspace URL to the **Allowed to send notifications** list. + + .. tab:: Edge + + Grant notification permissions for Mattermost in your Edge web browser. + + 1. From the Edge menu, select the **Settings and more (...)** option. + 2. Select **Cookies and Site Permissions** in the left pane. + 3. Under **All Permissions**, **select Notifications**. + 4. Add your Mattermost workspace URL to the **Allow** section. + + .. tab:: Firefox + + Grant notification permissions for Mattermost in your Firefox web browser. + + 1. From the Firefox menu, select **Settings**. + 2. Select **Privacy and Security** in the left pane. + 3. Under **Permissions**, select the **Settings** option for **Notifications**. + 4. Enable notifications for your Mattermost workspace URL in the **Permissions** list. + + .. tab:: Safari + + Grant notification permissions for Mattermost in your Safari web browser. + + 1. From the Safari menu, select **Preferences**. + 2. Select **Websites** and select **Notifications** in the left pane. + 3. Enable notifications for your Mattermost site. + +.. tab:: Mobile + + Ensure that your mobile device isn't blocking device settings. Visit the **Android** or **iOS** tab below based on your mobile device type. + + .. tab:: Android + + Ensure that your Android device isn't blocking Mattermost notifications by granting notification permission for Mattermost in device settings. + + 1. Open the Android **Settings app**, and tap **Application Manager**. + 2. Locate **Google Play Services** and enable notifications for it. + 3. Locate **Mattermost** and enable notifications for it. + + Also ensure that your Android device isn't set to **Do Not Disturb** mode which is designed to block notifications. See the `Android help `_ documentation to learn more. + + .. tab:: iOS + + Ensure that your iOS device isn't blocking Mattermost notifications by granting notification permission for Mattermost in device settings. + + 1. Open the iOS **Settings app** and tap **Notifications**. + 2. In the list of apps, tap **Mattermost**. + 3. Enable the **Allow notifications** toggle and set **Notification Delivery** to **Immediate Delivery**. + + Also ensure that your iOS device isn't set to **Do Not Disturb** mode or a **Focus mode** designed to block notifications. See the `iOS support `_ documentation to learn more. + +We recommend checking your operating system settings next. + +Check your Operating System settings +------------------------------------ + +The operating system you're running Mattermost on can also block Mattermost notifications. Select the **Linux**, **macOS**, or **Windows** tab based on your operating system: + +.. tab:: Windows + + If you're using Mattermost on a Windows machine, you must enable notifications from Mattermost and turn off both Do Not Disturb mode and Focus Assist. If you don't, Windows can block you from receiving Mattermost notifications. + + 1. Open **Windows Settings** and go to **System > Notifications & actions**. + 2. Ensure that **Get notifications from apps and other senders**, is enabled. + 3. Find Mattermost in the list and enable notifications. + + Also ensure that Windows’ **Do Not Disturb** mode and **Focus Assist** is turned off. See the Windows support docmentation on `Do Not Disturb mode `_ and `Focus Assist `_ to learn more. + +.. tab:: Linux + + If you're using Mattermost on a Linux machine, you must enable pop-up notifications from Mattermost and turn off Do Not Disturb mode. If you don't, Linux can block you from receiving Mattermost notifications. + + 1. Open **Settings**, then go to **Notifications**. + 2. Enable the **Show Pop-up Notifications** option. + 3. Enable the **Show Notification Center** to review and manage your Mattermost notifications. + + Also ensure that **Do Not Disturb** mode is turned off. + +.. tab:: macOS + + If you're using Mattermost on a macOS machine, you must enable application notifications for Mattermost and turn off focus mode. If you don't, macOS can block you from receiving Mattermost notifications. + + 1. Open **System Settings** and go to **Notifications**. + 2. Under **Application Notifications**, ensure notifications are enabled. + + Also ensure that macOS’ **Focus mode** is turned off. See the Apple Support `Focus mode `_ documentation to learn more. \ No newline at end of file