Queue Tools enhances Reddit’s moderation queue pages with information and controls that are missing from Reddit’s native interface. It surfaces previous mod actions on each item from the subreddit’s modlog, automatically expands report details, adds color-coded subreddit borders to multi-subreddit queues, and replaces the default empty-queue state with a configurable creature of your choice. On old Reddit, it also adds mass action controls, sorting, threshold filtering, AutoModerator action reason display, and comment grouping.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.
Action reason display
WhenshowActionReason is enabled (the default), Toolbox fetches the last 500 entries from the subreddit’s modlog and displays a recent actions table next to each post or comment that appears in those entries.
The action table shows four columns:
| Column | Content |
|---|---|
| mod | The moderator who took the action |
| action | The action type (e.g. removelink, approvecomment) |
| details | The action details or AutoModerator rule name |
| time | A relative timestamp (e.g. “3 hours ago”) |
expandActionReasonQueue is enabled. On other pages, a show recent actions / hide recent actions toggle controls visibility.
The modlog cache is refreshed automatically after 5 minutes. If you take an action and the table does not immediately reflect it, wait for the next cache cycle or reload the page.
Report expansion
TheexpandReports setting automatically expands the report details section on all items when you load a mod page. Without this setting, report reasons are collapsed by default and require an extra click to view.
On old Reddit, the Queue Tools toolbar also includes a expand reports / collapse reports toggle button that shows or hides all report reason sections at once for the current page load. New items loaded via Reddit Enhancement Suite’s Never Ending Reddit are also processed and reports are expanded if the setting is active.
Subreddit color coding
WhensubredditColor is enabled, Toolbox adds a 3px left border to each queue item, colored uniquely by subreddit name. The color is generated deterministically from the subreddit name plus the subredditColorSalt string using a string-to-color hashing function, so the same subreddit always gets the same color.
This is particularly useful on multi-subreddit queues (e.g. /r/mod) where posts from many different communities are interleaved, making it immediately obvious which subreddit each item belongs to.
Queue Creature
When the mod queue is empty, Reddit displays a default “The queue is clean!” message. Toolbox replaces this with an animated creature image. The creature is shown onqueueListing page types and the replacement runs twice (with a 500ms delay) to reliably catch the element after React renders it.
kitteh
A cat. The default. Dignified, judgmental, and appropriate for moderation work.
puppy
A puppy. Enthusiastic approval of an empty queue.
/r/babyelephantgifs
A baby elephant. Community-sourced queue celebration.
/r/spiderbros
A friendly spider. For mods who appreciate their arthropod colleagues.
piggy
A pig. Photo credit: Michael Coghlan on Flickr.
i have no soul
No creature. Disables the feature and shows Reddit’s default empty state.
Old Reddit: mass action toolbar
On old Reddit, Queue Tools adds a persistent toolbar above the item list on mod queue and reports pages. The toolbar provides:Selection and filtering
Selection and filtering
A select all checkbox selects every visible item. Invert flips the current selection. The select… dropdown opens a popup with granular filter options: by type (comments, submissions, text posts, posts with flair), by status (shadow-banned, spam-filtered, reported, actioned, removed, approved, spammed, ignored), by domain, by username, by title text, by subreddit, and by score thresholds (greater than / less than a given number).
Mass actions
Mass actions
With one or more items selected, click spam selected, remove selected, approve selected, or ignore reports on selected to apply that action to all checked items at once via the Reddit API.
Sorting
Sorting
A sort dropdown lets you reorder the current page by: age (default), edited time, removed time, reports count, or score. Clicking the currently selected sort order toggles between ascending and descending. Sort preference is saved to Toolbox settings.
Report threshold
Report threshold
A numeric Report threshold input hides any item with fewer reports than the specified number. Set to
0 (the default) to show all items. The threshold is applied automatically to new items loaded via Never Ending Reddit.AutoModerator action reasons
AutoModerator action reasons
When
showAutomodActionReason is enabled, Toolbox fetches the last 500 AutoModerator modlog entries and displays the matching action reason below any item that AutoModerator removed. A ask for a second opinion in modmail link is also added for quick escalation.When highlightAutomodMatches is enabled, words enclosed in [] in AutoModerator reports are highlighted in the item’s title and body text, making it easy to see which regex match triggered the rule.Comment grouping
Comment grouping
Settings reference
showActionReason — Show previously taken actions next to submissions
showActionReason — Show previously taken actions next to submissions
Type: boolean
Default:
Default:
trueFetches the last 500 entries from the subreddit modlog and displays a table of previous mod actions next to each matching post or comment. The modlog cache expires after 5 minutes.expandActionReasonQueue — Automatically expand the mod action table in queues
expandActionReasonQueue — Automatically expand the mod action table in queues
Type: boolean
Default:
Default:
trueWhen enabled on queue listing pages, the mod action history table for each item is expanded by default rather than hidden behind a toggle button.expandReports — Automatically expand reports on mod pages
expandReports — Automatically expand reports on mod pages
Type: boolean
Default:
Default:
falseWhen enabled, Toolbox automatically expands the report reasons section on every item when the page loads and for new items loaded dynamically. Without this setting, report reasons are collapsed by default.queueCreature — Queue Creature shown on empty queues
queueCreature — Queue Creature shown on empty queues
Type: selector
Default:
Options:
Default:
kittehOptions:
kitteh, puppy, /r/babyelephantgifs, /r/spiderbros, piggy, i have no soulControls which creature image Toolbox displays when the mod queue is empty. Select i have no soul to disable the feature entirely and show Reddit’s default empty-queue text.subredditColor — Add a color border to queue items by subreddit
subredditColor — Add a color border to queue items by subreddit
Type: boolean
Default:
Default:
falseWhen enabled, adds a 3px solid left border to each queue item. The border color is unique to the subreddit name (combined with subredditColorSalt) and is applied only on subreddits you moderate.subredditColorSalt — Text to shift the subreddit color palette (advanced)
subredditColorSalt — Text to shift the subreddit color palette (advanced)
Type: text
Default:
Default:
PJSaltA string appended to the subreddit name before color generation. Changing this value reassigns all subreddit colors. Only visible in settings when subredditColor is enabled.showReportReasons — Add button to show reports on posts with ignored reports
showReportReasons — Add button to show reports on posts with ignored reports
Old Reddit-only settings
These settings only apply when using the old Reddit interface (old.reddit.com).
| Setting | Type | Default | Description |
|---|---|---|---|
autoActivate | boolean | true | Automatically activate the mass queue tools toolbar on queue pages without requiring a manual click. |
highlightNegativePosts | boolean | false | Highlight posts with a score of 0 or below with a distinct visual style. |
hideActionedItems | boolean | false | Hide items from view immediately after taking a mod action on them. |
showAutomodActionReason | boolean | true | Display the AutoModerator action reason below items that AutoModerator removed. |
linkToQueues | boolean | false | Make subreddit name links in queue items point directly to that subreddit’s mod queue instead of its front page. |
reportsOrder | selector | age | Default sort order for the queue. Options: age, edited, removed, score, reports. |
reportsThreshold | number | 0 | Minimum report count required to show an item. Items with fewer reports are hidden. |
reportsAscending | boolean | false | Sort the queue in ascending order when enabled. |
botCheckmark | list | AutoModerator | Comma-separated list of bot usernames whose approval checkmarks display with a distinct bot icon. Case-sensitive. |
highlightAutomodMatches | boolean | true | Highlight words enclosed in [] in bot mod reports and action reasons to surface regex match context. |
groupCommentsOnModPage | boolean | false | Group comments by their parent submission when viewing mod listings (advanced). |
groupCommentsOnModPageis enabled (advanced), Toolbox groups comments on mod listing pages by their parent submission, with a horizontal rule between groups. This makes it easier to see all reported comments from the same post together.