Skip to main content

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.

The Mod Bar is a persistent toolbar fixed to the bottom of every Reddit page you visit while logged in. It is always enabled and cannot be disabled — it is the foundation that other Toolbox modules attach buttons and counters to. The bar surfaces live counts for your modqueue, unmoderated queue, new modmail, and unread messages, and provides a one-click dropdown to every subreddit you moderate.
The Mod Bar is alwaysEnabled: true in the module configuration. It cannot be turned off from the Toolbox settings panel.

​
What the Mod Bar shows

The right side of the bar contains the counter section with four icons and their live counts:

User inbox

Links to /message/inbox/ by default. Highlights and shows an unread count when you have new messages. If Link to unread when messages present is enabled, the link switches to /message/unread/ when the count is greater than zero.

New modmail

Links to mod.reddit.com in the category you configure (all, inbox, new, in-progress, archived, highlighted, mod discussions, or notifications). Hovering over the icon reveals a tooltip with per-category breakdown: New, In Progress, Ban Appeals, Join Requests, Highlighted, Mod Discussions, and Notifications.

Modqueue

Links to /r/SUBREDDITS/about/modqueue or /me/f/mod/about/modqueue/ if the feed-based setting is active. The count shown is fetched and cached by the Notifier module.

Unmoderated queue

Links to /r/SUBREDDITS/about/unmoderated. Only shown when Show icon for unmoderated is enabled (the default). The count is fetched by the Notifier module.
The left side of the bar holds the Moderated Subreddits button (when enabled) and your configured shortcuts, followed optionally by an Open in old/new Reddit toggle.

​
Moderated subreddits list

When Show Moderated Subreddits is enabled (the default), the bar shows a Moderated Subreddits button on the left. Clicking it opens a popup listing every subreddit you moderate with a color-coded left border unique to each subreddit name. Each row provides direct icon links to:
  • The subreddit front page
  • The subreddit modqueue (/about/modqueue)
  • The unmoderated queue (/about/unmoderated)
  • The moderation log (/about/log)
  • Traffic stats (/about/traffic)
  • Usernotes config (if the UserNotes module is enabled)
  • Toolbox subreddit config (if the TBConfig module is enabled)
A live search field at the top of the popup filters the list as you type. The counter next to the search field updates to show the number of currently visible rows.

​
Compact mode

When Use compact mode for modbar is enabled (an advanced setting), the bar starts collapsed on every page load. In compact mode the visible handle is a small dot-menu icon rather than the usual arrow. Hovering over the collapsed handle does not show the counter tooltip — it only appears in non-compact mode. Disable compact mode if you want the bar visible at all times.
In normal (non-compact) mode, hovering over the collapsed arrow shows a tooltip with current counts for new messages, modqueue, unmoderated queue, modmail, and new modmail — useful when you have collapsed the bar but still want a quick count glance.

​
Old Reddit / new Reddit toggle

When Include a button to swap between old and new Reddit is enabled (the default), the bar adds an Open in old Reddit or Open in new Reddit link to the left section. The button adapts to the current page:
  • On old.reddit.com, clicking it opens the equivalent page on www.reddit.com (new Reddit).
  • On new Reddit or sh.reddit.com, clicking it opens the equivalent page on old.reddit.com.
The link updates automatically as you navigate between pages.

​
Custom shortcuts

The Shortcuts setting (type: map) stores a name-to-URL map. Each entry appears as a clickable link in the left section of the bar between the moderated subreddits button and the old/new toggle. Shortcuts are configured through the Toolbox settings panel using the name and URL labels. 
name  →  url
Support wiki  →  /r/mysubreddit/wiki/support
Rules  →  /r/mysubreddit/wiki/rules

​
Settings reference

Type: boolean
Default: falseWhen enabled, the Mod Bar starts in the hidden state on every page load and shows only a small dot-menu icon as the expand handle. Click the handle to reveal the full bar. Hovering over the handle in compact mode does not display the counter tooltip.
Type: boolean
Default: trueWhen enabled, adds an unmoderated queue icon and count to the right counter section of the bar. The icon links to the subreddit or feed configured in the Notifier module’s unmoderatedSubreddits setting.
Type: boolean
Default: trueWhen enabled, shows a Moderated Subreddits button in the left section of the bar. Clicking the button opens a popup listing all subreddits you moderate, each with color-coded quick-action icon links and a live filter input.
Type: boolean
Default: trueWhen enabled, adds an Open in old Reddit or Open in new Reddit link to the left section of the bar. The link converts the current page URL between old.reddit.com and www.reddit.com (or sh.reddit.com) and updates as you navigate.
Type: map
Default: {}
Labels: name, urlA map of display names to URLs. Each entry is rendered as a clickable link in the left section of the bar. Entries are displayed in the order they were added. Configure through the Toolbox settings panel.

Build docs developers (and LLMs) love

Get started for freeTalk to us