This guide explains how the notifications menu works in Discourse, including the different types of notifications and where they appear in the interface.
Required user level: All users
Notifications are an essential part of the Discourse experience, keeping you informed about activity relevant to you. This guide will walk you through the different types of notifications and how to interact with them.
Types of notifications
Discourse uses various icons and colors to indicate different types of notifications:
- Personal messages: A green envelope icon on your avatar indicates new personal messages.
- Other notifications: A blue counter on your avatar shows other types of notifications (e.g., replies, mentions, likes).
-
Chat notifications:
- A green counter on the chat icon indicates personal chat messages.
- A blue counter on the chat icon shows unread messages in chat channels.
- Reviewable items: For users with review permissions, a red flag icon appears on the avatar, indicating items to review (e.g., user registrations, posts to approve, flagged posts).
Note: Only one indicator is shown on your avatar at a time, in priority order: personal messages, reviewable items, then other notifications.
Accessing notifications
Chat notifications
Click the chat icon to open the chat window, where you can see which users and channels the notifications are linked to.
Other notifications
Click your avatar to remove the notification icon and display all unseen notifications in a menu with several tabs.
In this menu:
- Unread notifications appear with a highlighted background at the top of the list.
- Click the icons on the right to filter notifications by type.
- Use the “
Dismiss” button to mark all notifications in the current tab as read.
Notification types
Here’s a breakdown of the notification types you’ll find in the menu:
-
All notifications -
Replies -
Likes -
Personal messages -
Bookmarks -
Chat notifications -
Review queue (users with review permissions) -
Other notifications
Additional resources
For developers interested in the technical details, you can find all the notification types defined in app/models/notification.rb.
Last edited by @sam 2026-03-18T04:34:27Z
Last checked by @hugh 2024-06-28T01:59:33Z
Check document
Perform check on document: