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.
- Moderator notifications: For moderators, red flag icons appear on the avatar, indicating items to review (e.g., user registrations, posts to approve, flagged posts).
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 and mentions
- Liked posts
- Private messages
- Bookmark reminders
- Chat notifications
- Reviewable items (Moderators only)
- Other notifications
Additional resources
For developers interested in the technical details, you can find all the notification types defined here in the Discourse codebase.
Last edited by @hugh 2024-06-28T01:59:27Z
Last checked by @hugh 2024-06-28T01:59:33Z
Check document
Perform check on document: