Manage your notifications#

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

Mattermost notifies you of new activity in the following ways:

Badges: In Mattermost, badges show you when you have unread messages and threads.

  • A dot on the badge means you have unread activity in at least one channel you're a member of. You have unread activity in at least one channel you’re a member of.

  • A numbered badge means you have at least 1 unread message, @mention, or one of your keywords has triggered a notification. You have at least one unread direct message, group message, @mention, or a keyword triggered a notification.

Banner alerts: Pop-ups alert you to new activity.

Push notifications: Mobile app alert you to new activity when you’re on the go.

Sounds: Audible sounds alert you to new activity.

Mattermost Academy Learn about notifications

Get notified#

You can configure Mattermost to receive increase or decrease the number of notifications based on your preferences.

In a web browser or the desktop app, select the Settings Use the Settings icon to customize your Mattermost user experience. icon located in the top right corner of the screen to manage your notification preferences.

On mobile, select the Settings Use the Settings icon to customize your Mattermost user experience. icon and tap Notifications.

By default, you’re notified of all Mattermost activity in both a web browser and the desktop app with badges, banner alerts, and sounds. In supported web browsers, the tab’s favicon also notifies you of unread messages with an asterisk (*) and a count.

Too many notifications!

If that’s too many notifications, you can configure Mattermost to notify you for only mentions and direct messages. Select Desktop Notifications > Only for mentions and direct messages.

Disable web and desktop notifications altogether by selecting Desktop Notifications > Never.

Too loud

You can change or disable the audible sound for notifications. Go to Desktop notifications > Notification sound, and choose a different sound or turn the sound off.

Incoming call sounds

Want to hear a sound when a Mattermost call starts? If your Mattermost admin 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.

You can disable incoming call sounds altogether if preferred.

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 enables this feature, you’ll receive batches of notifications by email every 15 minutes, or as configured by your admin.

By default, you’re notified of all Mattermost activity in the mobile app when you’re away or offline for more than 5 minutes.

Too many notifications!

If that’s too many notifications, you can configure Mattermost to notify you for only mentions and direct messages. Select Mobile Push Notifications > For mentions and direct messages.

Only notify me when I’m offline

If you prefer to be notified of all activity, but only when you’re offline, select For all activity and then select Offline.

Turn off all mobile notifications by selecting Mobile Push Notifications > Never.

Not enough notifications

If you prefer to always be notified, regardless of your user status, select Mobile Push Notifications > Trigger push notifications when > Online, away or offline.

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 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 Tab, and use Backspace to manage keywords.

A walkthrough of setting keywords that trigger mentions in Mattermost.

Passively track keywords (no notification)

Note

plans-img-yellow Available only on Enterprise and Professional plans

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 Mattermost theme.

A walkthrough of setting keywords that are highlighted in Mattermost.

If Collapsed Reply Threads 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 Collapsed Reply Threads 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.

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.

  • Or select the View Info Use the Channel Info icon to access additional channel management options. icon, and select Notification Preferences in the right pane.

You can set notification preferences at the channel level for every channel you’re a member of. You have 2 ways to access channel preferences:

  • Select the channel name, then select Notification Preferences.

  • Or select the View Info Use the Channel Info icon to access additional channel management options. icon, and 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 Use the More icon to access additional message options. 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 @ 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.

  • 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.

  • 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.

  • Select Reset to default to return to global defaults.

Desktop notifications

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.

Mobile push notifications

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.

Auto-follow all new threads in this channel

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.

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.

Tip

Missing notifications? Visit our notifications knowledge base article for additional troubleshooting tips and tricks.