After installing Toolbox, everything activates automatically the next time you visit Reddit as a moderator. There is no separate sign-in or onboarding wizard — Toolbox reads your moderator status from your Reddit session and begins enhancing the interface immediately. This guide walks you through the key features you will encounter in your first session.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.
You must be a moderator of at least one subreddit for Toolbox’s interface elements to appear. Toolbox does not display anything on subreddits you do not moderate.
Step 1: Find the mod bar
Navigate to any Reddit page
Go to reddit.com and make sure you are logged in with a moderator account.
Locate the Toolbox mod bar
A persistent bar appears at the bottom of every Reddit page. It shows the names of your moderated subreddits, each with an unmoderated item count in parentheses when items are pending review.
Step 2: Set up User Notes for a subreddit
User Notes lets you and your co-moderators attach persistent, labeled notes to Reddit users. Notes are stored in your subreddit wiki and visible to all mods.Navigate to a subreddit you moderate
Go to the subreddit where you want to enable User Notes, for example
reddit.com/r/yoursubreddit.Open Toolbox settings and find User Notes
Click the Toolbox link in the mod bar. In the settings panel, locate the User Notes section.
Initialize the usernotes wiki page
If User Notes has never been configured for this subreddit, Toolbox prompts you to create the wiki page. Click Create to initialize
wiki/usernotes in your subreddit. This requires wiki edit permissions.User Notes are visible only to moderators of the subreddit. They are stored in
wiki/usernotes as compressed JSON. You must have wiki edit access to create or modify notes.Step 3: Configure Removal Reasons
Removal Reasons lets you define message templates that are sent to users when their content is removed. Toolbox presents your reason list whenever you remove a post or comment.Open Toolbox settings on your subreddit
Navigate to your subreddit and open the Toolbox settings panel from the mod bar.
Go to the Removal Reasons section
In the settings panel, locate Removal Reasons and expand it. If no reasons exist yet, Toolbox shows an empty list with an Add reason button.
Add a removal reason
Click Add reason. Fill in the reason title and the message body. You can use template placeholders in the body:
| Placeholder | Replaced with |
|---|---|
{author} | The username of the removed content’s author |
{subreddit} | The subreddit name |
{kind} | post or comment |
{title} | The post title |
{url} | A link to the removed content |
Choose how reasons are sent
In the Method setting, select whether Toolbox posts the removal message as a comment reply, a private message, or both. You can also configure whether replies are sent as the subreddit’s ModTeam account.
Step 4: Use Queue Tools in the mod queue
Queue Tools enhances the mod queue with additional context and controls. It is enabled by default and requires no per-subreddit configuration to begin working.Open your subreddit's mod queue
Navigate to
reddit.com/r/yoursubreddit/about/modqueue or click the queue link in the mod bar.Review action history
Each item in the queue shows a table of previously taken mod actions sourced from your subreddit’s mod log (up to the last 500 entries). This tells you whether a piece of content has already been reviewed by another moderator.
Enable subreddit color coding (optional)
In the Queue Tools section of Toolbox settings, enable Subreddit color coding to add a unique colored border to each item based on which subreddit it belongs to. This is especially useful when moderating a combined queue across multiple subreddits.
Tips for new moderators
Per-subreddit settings
All Toolbox feature configurations are stored in the subreddit wiki, not your browser. Changes you make apply to all moderators of that subreddit.
Module toggles
Each Toolbox module can be enabled or disabled independently in the settings panel. Disable modules you don’t use to keep the interface focused.
Co-mod visibility
User Notes and Removal Reason templates are immediately visible to all co-moderators once saved to the wiki — no need to share files or sync manually.
Wiki permissions required
Configuring User Notes and Removal Reasons writes to your subreddit wiki. If you cannot save settings, check that your account has wiki edit permissions for that subreddit.
Explore features in depth
User Notes
Note types, bulk management, and wiki schema details
Removal Reasons
Template syntax, delivery methods, and log subreddit setup
Queue Tools
Action history, report expansion, and color coding options
Mod Bar
Shortcuts, compact mode, and unmoderated count configuration