The Notifier module runs in the background and periodically checks your modqueue, unmoderated queue, unread messages, and new modmail. When new items are detected it updates the counters in the Mod Bar, fires browser notifications, and optionally plays a sound. It is enabled by default and works across all subreddits you moderate without requiring any per-subreddit setup.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/toolbox-team/reddit-moderator-toolbox/llms.txt
Use this file to discover all available pages before exploring further.
How polling works
On every poll cycle the Notifier fetches counts from the Reddit API for each queue you have configured. It compares the new counts against the values stored from the previous cycle and fires notifications only when a count has increased. Results are cached in extension storage so the Mod Bar counters survive page navigation without an additional network request.The default poll interval is 1 minute. Reducing it increases API request frequency. Reddit’s rate limits apply — very short intervals may cause requests to fail silently.
Notification types
Message notifications
Fires a browser notification when your unread inbox count increases. By default the notification links directly to the message thread; enable Link to unread to send the click to
/message/unread/ instead.Modqueue notifications
Fires a browser notification when the modqueue count for your configured subreddit multireddit increases. Links to the modqueue feed.
Unmoderated notifications
Fires a browser notification when the unmoderated queue count increases. Disabled by default. Enable with Get unmoderated queue notifications.
Sound alerts
Plays an audio chime when a new message notification fires. Disabled by default. Use the Sample sound action in settings to preview the chime before enabling it.
Configuring subreddit feeds
By default the Notifier monitorsr/mod, which covers every subreddit you moderate. You can scope each counter to a different multireddit by entering its path in the corresponding setting.
Set the modqueue feed
Enter the multireddit path (e.g.
mod or mymod+mysub2) in Multireddit for modqueue counter. Enable Use /f/mod/about/modqueue/ to use the newer feed-based URL instead.Set the unmoderated feed
Enter the multireddit path in Multireddit for unmoderated counter. Enable Use /f/mod/about/unmoderated/ to use the feed-based URL.
Consolidated vs. individual notifications
When Consolidate notifications is enabled (the default), multiple new items trigger a single “X new messages” browser notification rather than one notification per item. This prevents notification spam during periods of high queue activity.Settings reference
modSubreddits — Multireddit for modqueue counter
modSubreddits — Multireddit for modqueue counter
Type: text
Default:
Default:
modThe multireddit path used to build the modqueue URL that the Notifier polls and that the Mod Bar counter links to. Use mod to cover all moderated subreddits, or enter a custom multireddit name.modSubredditsFMod — Use /f/mod/about/modqueue/
modSubredditsFMod — Use /f/mod/about/modqueue/
Type: boolean
Default:
Default:
falseWhen enabled, the Notifier polls and links to the feed-based URL /me/f/mod/about/modqueue/ instead of building a URL from the modSubreddits path.unmoderatedSubreddits — Multireddit for unmoderated counter
unmoderatedSubreddits — Multireddit for unmoderated counter
Type: text
Default:
Default:
modThe multireddit path used to build the unmoderated queue URL. Follows the same format as modSubreddits.unmoderatedSubredditsFMod — Use /f/mod/about/unmoderated/
unmoderatedSubredditsFMod — Use /f/mod/about/unmoderated/
Type: boolean
Default:
Default:
falseWhen enabled, uses /me/f/mod/about/unmoderated/ as the unmoderated feed URL.messageNotifications — Get notifications for new messages
messageNotifications — Get notifications for new messages
Type: boolean
Default:
Default:
trueWhen enabled, fires a browser notification whenever your unread inbox count increases since the last poll.messageNotificationSound — Play sound on new message
messageNotificationSound — Play sound on new message
Type: boolean
Default:
Default:
falseWhen enabled, plays an audio chime alongside the browser notification for new messages. Use the Sample sound action in settings to preview the audio before turning this on.messageUnreadLink — Link to /message/unread/ when messages present
messageUnreadLink — Link to /message/unread/ when messages present
Type: boolean
Default:
Default:
falseWhen enabled, the inbox counter in the Mod Bar links to /message/unread/ whenever the unread count is greater than zero, instead of the default /message/inbox/.modNotifications — Get modqueue notifications
modNotifications — Get modqueue notifications
Type: boolean
Default:
Default:
trueWhen enabled, fires a browser notification when the modqueue count increases.unmoderatedNotifications — Get unmoderated queue notifications
unmoderatedNotifications — Get unmoderated queue notifications
Type: boolean
Default:
Default:
falseWhen enabled, fires a browser notification when the unmoderated queue count increases.checkInterval — Poll interval in minutes (advanced)
checkInterval — Poll interval in minutes (advanced)
Type: number
Default:
Default:
1How often (in minutes) the Notifier polls Reddit for new counts. Setting this too low may trigger Reddit rate limits.straightToInbox — Go to inbox on comment notification click (advanced)
straightToInbox — Go to inbox on comment notification click (advanced)
Type: boolean
Default:
Default:
falseWhen enabled, clicking a comment notification opens /message/inbox/ rather than the individual comment permalink.consolidatedMessages — Consolidate notifications (advanced)
consolidatedMessages — Consolidate notifications (advanced)
Type: boolean
Default:
Default:
trueWhen enabled, multiple new items produce a single “X new messages” notification rather than one notification per item.