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.

Moderator Toolbox installs like any other browser extension — no account creation, no separate app, no configuration required before use. Once installed, it activates automatically on any reddit.com page when you are logged in as a moderator. Choose your browser below to get started.

​
Install from an extension store

1

Open the Chrome Web Store listing

Go to the Moderator Toolbox listing on the Chrome Web Store.
2

Add to Chrome

Click Add to Chrome, then click Add extension in the confirmation dialog.
3

Verify installation

Navigate to any Reddit page. The Toolbox mod bar appears at the top of the page if you are a moderator of at least one subreddit.

​
Install from source (developer mode)

If you want to run a local build — for development, testing unreleased changes, or contributing to the project — you can load the extension as an unpacked directory directly from your browser.

​
Build the extension

You need Node.js installed before running these commands. 
git clone https://github.com/toolbox-team/reddit-moderator-toolbox.git
cd reddit-moderator-toolbox
npm install
npm run build
Build output is written to build/chrome and build/firefox. To automatically rebuild whenever you change a source file, use: 
npm run build:watch

​
Load the unpacked extension

1

Open the extensions page

In Chrome, navigate to chrome://extensions. In Edge, navigate to edge://extensions.
2

Enable developer mode

Toggle on Developer mode in the top-right corner of the page.
3

Load the build directory

Click Load unpacked, then select the build/chrome directory from your local clone.
4

Confirm the extension loaded

Moderator Toolbox appears in your extension list. Navigate to Reddit to verify.

​
Required permissions

When you install Toolbox, your browser requests the following permissions:
PermissionWhy Toolbox needs it
cookiesReads Reddit session cookies to authenticate API requests
tabsDetects navigation between Reddit pages to re-inject UI
storagePersists your local Toolbox preferences
unlimitedStorageCaches mod log and usernote data locally for performance
notificationsShows browser notifications for new queue items and modmail
webNavigationTracks page transitions on single-page Reddit to update the mod bar
alarmsSchedules periodic checks for new queue items and modmail
Toolbox only activates on reddit.com, old.reddit.com, oauth.reddit.com, and mod.reddit.com. It does not run on any other site.

​
Next steps

Quick start guide

Set up your first subreddit and start using core features

User Notes

Learn how to configure and use User Notes for your subreddit

Build docs developers (and LLMs) love

Get started for freeTalk to us