help: Improve documentation on troubleshooting desktop notifications.

This commit is contained in:
Alya Abbott 2024-06-25 15:59:15 -07:00 committed by Tim Abbott
parent 6aa3a55796
commit 53f97115a4
1 changed files with 30 additions and 6 deletions

View File

@ -65,11 +65,20 @@ and [mentions](/help/mention-a-user-or-group), or to include messages in
{end_tabs} {end_tabs}
## Troubleshooting desktop notifications ## Testing desktop notifications
First, make sure you have enabled {start_tabs}
[desktop notifications for DMs](/help/dm-mention-alert-notifications) or for the
[channel](/help/channel-notifications) you are testing with. {tab|desktop-web}
{settings_tab|notifications}
1. Under **Desktop message notifications**, click **Test desktop notification**.
If notifications are working, you will receive a **Test notification**.
{end_tabs}
## Troubleshooting desktop notifications
Desktop notifications are triggered when a message arrives, and Zulip is not Desktop notifications are triggered when a message arrives, and Zulip is not
in focus or the message is offscreen. You must have Zulip open in a browser in focus or the message is offscreen. You must have Zulip open in a browser
@ -78,11 +87,25 @@ tab or in the Zulip desktop app to receive desktop notifications.
**Visual desktop notifications** appear in the corner of your main monitor. **Visual desktop notifications** appear in the corner of your main monitor.
**Audible desktop notifications** make a sound. **Audible desktop notifications** make a sound.
The most common issue is that your browser or system settings are blocking To receive notifications in the desktop app, make sure that [Do Not Disturb
notifications from Zulip. mode](/help/do-not-disturb) is turned off.
### Check notification settings for DMs or channels
If you have successfully received a [test
notification](#testing-desktop-notifications), but you aren't seeing desktop
notifications for new messages, check your Zulip notification settings. Make
sure you have enabled desktop notifications [for
DMs](/help/dm-mention-alert-notifications) or [for the
channel](/help/channel-notifications) you are testing. Messages in [muted
topics](/help/mute-a-topic) will not trigger notifications.
### Check platform settings ### Check platform settings
The most common issue is that your browser or system settings are blocking
notifications from Zulip. Before checking Zulip-specific settings, make sure
that **Do Not Disturb mode** is not enabled on your computer.
{start_tabs} {start_tabs}
{tab|chrome} {tab|chrome}
@ -141,6 +164,7 @@ Alternate instructions:
{end_tabs} {end_tabs}
## Related articles ## Related articles
* [Channel notifications](/help/channel-notifications) * [Channel notifications](/help/channel-notifications)