As both a reddit user and a moderator of a moderately large subreddit, I believe there are two overarching reasons to publicize the actions that moderators take:
- From the user's perspective, the transparency provided by these logs will help build trust in the community.
- From the moderator's perspective, it will (hopefully) help cut down on the shill/nazi/etc accusations.
Mod Logs offers moderators flexibility in what they show in the logs, as well as some report functionality to sweeten the deal.
If you're a moderator of a subreddit that would like to opt-in to public moderation logs, follow these simple steps:
- Add /u/modlogs as a moderator of your subreddit. See the note on permissions below.
- Create a
modlog_configentry in your wiki. It should be accessible at /r/yourSub/wiki/modlog_config. If you make it viewable only by moderators, you'll need to give /u/modlogs the
wikimod permission. See the configuration section below.
You can add /u/modlogs as a moderator with no permissions, but if you want to use a custom configuration you'll need to give it the
If you want to customize the logs that are publicly available, you can create a wiki page on your subreddit. The page should be available at /r/yourSub/wiki/modlog_config.
The configuration is in YAML format, similar to AutoModerator config.
If you don't provide a custom configuration, the following default configuration will be used:
# show a permalink to the moderated comment or submission show_comment_links: false show_submission_links: false # show the contents of the moderated comment or submission show_comment_contents: false show_submission_contents: false # show the author of the comment or submission show_comment_author: false show_submission_author: false # show the submission title show_submission_title: false # show the name of the moderator who performed the action show_moderator_name: false # show the name of the user who was banned or unbanned show_ban_user: true # show the duration of a ban show_ban_duration: true # show the internal mod note on the ban show_ban_description: false # show the name of the user who was muted or unmuted show_muted_user: false # show the AutoModerator action_reason (https://www.reddit.com/wiki/automoderator/full-documentation#wiki_actions) show_automod_action_reasons: false # a comma-separated list of actions to include or exclude. include takes precedence. # by default all actions are included, see below for available actions include_actions:  exclude_actions:  # a comma-separated list of moderators to include or exclude. include takes precedence. # by default all moderators in the subreddit are included include_moderators:  exclude_moderators: 
The following moderation actions can be used in the
exclude_actions configuration items:
Reddit doesn't currently offer moderators any means to analyze user behavior in their subs. Mod Logs offers two types of reports.
In order to run a report, just send a modmail message from the desired subreddit to /u/modlogs with "report" as the subject. In the body of the message, provide the options detailed in the report types below. Options must be provided in YAML format, like the modlog configuration earlier.
Report requests must be sent via your subreddit's modmail, or the message will be ignored.
This report type provides a list of users sorted by the total number of comment and submission removals they've had in the subreddit.
Moderators are excluded from this report.
Example message body:
# this is required type: top offenders # optional, defaults to 5. the number of top offenders to include limit: 10 # optional, defaults to 1 month # example values: 1 day, 2 weeks, 3 months, 4 years, etc period: 3 months
Use this report type to get a more detailed report on a specific user. It returns a list of removed content, the total number of removals, and the percentage of removals to contributions (contributions are limited to 3 months due to limits of the Reddit API, so this percentage may be inaccurate for periods of greater than 3 months).
Example message body:
# this is required type: user # this is required username: spez # or /u/spez, either way is acceptable # optional, defaults to 1 month # example values: 1 day, 2 weeks, 3 months, etc period: 2 weeks