mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 13:33:24 +00:00
dedea23745
These files are not Jinja2 templates, so there's no reason that they needed to be inside `templates/zerver`. Moving them to the top level reflects their importance and also makes it feel nicer to work on editing the help center content, without it being unnecessary buried deep in the codebase.
137 lines
3.9 KiB
Markdown
137 lines
3.9 KiB
Markdown
# Desktop notifications
|
|
|
|
Zulip offers visual and audible desktop notifications. You can
|
|
customize whether [stream messages](/help/stream-notifications),
|
|
[private messages](/help/pm-mention-alert-notifications) and
|
|
[mentions](/help/pm-mention-alert-notifications#wildcard-mentions)
|
|
trigger desktop notifications.
|
|
|
|
{start_tabs}
|
|
|
|
{settings_tab|notifications}
|
|
|
|
1. Toggle the checkboxes for **Streams** and **PMs, mentions, and alerts**
|
|
in the **Desktop** column of the **Notification triggers** table.
|
|
|
|
{end_tabs}
|
|
|
|
## Notification sound
|
|
|
|
You can select the sound Zulip uses for audible desktop notifications. Choosing
|
|
**None** disables all audible desktop notifications.
|
|
|
|
### Change notification sound
|
|
|
|
{start_tabs}
|
|
|
|
{settings_tab|notifications}
|
|
|
|
1. Under **Desktop message notifications**, configure
|
|
**Notification sound**.
|
|
|
|
{end_tabs}
|
|
|
|
!!! tip ""
|
|
To hear the selected sound, click the <i class="fa fa-play-circle"></i> to the right of your selection.
|
|
|
|
## Unread count badge
|
|
|
|
By default, Zulip displays how many unmuted unread messages you have
|
|
in the organization on the [desktop app](https://zulip.com/apps/)
|
|
sidebar and on the browser tab icon. You can configure which types of
|
|
messages are included in the count. Choosing **None** disables unread
|
|
count badges.
|
|
|
|
### Configure unread count badge
|
|
|
|
{start_tabs}
|
|
|
|
{settings_tab|notifications}
|
|
|
|
1. Under **Desktop message notifications**, configure
|
|
**Unread count badge**.
|
|
|
|
{end_tabs}
|
|
|
|
## Troubleshooting desktop notifications
|
|
|
|
First, make sure you have enabled
|
|
[desktop notifications for PMs](/help/pm-mention-alert-notifications) or for the
|
|
[stream](/help/stream-notifications) you are testing with.
|
|
|
|
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
|
|
tab or in the Zulip desktop app to receive desktop notifications.
|
|
|
|
**Visual desktop notifications** appear in the corner of your main monitor.
|
|
**Audible desktop notifications** make a sound.
|
|
|
|
The most common issue is that your browser or system settings are blocking
|
|
notifications from Zulip.
|
|
|
|
### Check platform settings
|
|
|
|
{start_tabs}
|
|
|
|
{tab|chrome}
|
|
|
|
1. Click on **Secure** to the left of the URL bar. It should be green and
|
|
have a lock icon next to it.
|
|
|
|
1. Set **Notifications** and **Sound** to **Allow**.
|
|
|
|
Alternate instructions:
|
|
|
|
1. Open the Chrome **Edit** menu. Select **Preferences**.
|
|
|
|
2. On the top left, select the menu icon (<i class="fa
|
|
fa-bars"></i>). Select **Advanced**, and then **Privacy & Security**.
|
|
Click on **Content settings** (partway down the page), and select
|
|
**Notifications**.
|
|
|
|
3. If the Zulip URL for your organization is listed under **Blocked**,
|
|
select the menu icon (<i class="fa fa-ellipsis-v"></i>) to its right, and
|
|
click **Remove**.
|
|
|
|
4. Next to **Allow**, click **Add**.
|
|
|
|
5. Paste the Zulip URL for your organization into the site field, and click
|
|
**Add**.
|
|
|
|
{tab|firefox}
|
|
|
|
1. Open the Firefox **Edit** menu. Select **Preferences**.
|
|
|
|
2. On the left, select **Privacy & Security**. Scroll to the **Permissions**
|
|
section and select the **Settings** button next to **Notifications**.
|
|
|
|
3. Find the URL for your Zulip organization, and adjust the **Status**
|
|
selector to **Allow**.
|
|
|
|
{tab|desktop-app}
|
|
|
|
**Windows**
|
|
|
|
1. Click the **Start** button and select **Settings**. Select **System**,
|
|
and then **Notifications & actions**.
|
|
|
|
2. Select **Zulip** from the list of apps.
|
|
|
|
3. Configure the notification style that you would like Zulip to use.
|
|
|
|
**macOS**
|
|
|
|
1. Open your Mac **System Preferences** and select **Notifications**.
|
|
|
|
2. Select **Zulip** from the list of apps.
|
|
|
|
3. Configure the notification style that you would like Zulip to use.
|
|
|
|
{end_tabs}
|
|
|
|
## Related articles
|
|
* [Stream notifications](/help/stream-notifications)
|
|
* [PMs, mentions, and alerts](/help/pm-mention-alert-notifications)
|
|
* [Email notifications](/help/email-notifications)
|
|
* [Mobile notifications](/help/mobile-notifications)
|