r/modguide • • Jul 08 '20

Mobile modding Setting up your first sub on mobile

36 Upvotes

[The app is being worked on. This guide is as accurate as possible, to the best of our knowledge at time of posting - July 8th 2020 - and we'll update as necessary.]

We have a few guides on mobile modding now, but I hope to tie some things together, and add some more detail for new mods who have created their sub on mobile and are finding it hard to get their sub set up.

This guide is about the official reddit app.

See Modding on mobile - Milestone 1 update for creating a sub on mobile and some mobile modding tips.

In the creation process you can set your sub type, description, main topic, and icon/avatar. These can be edited later in app too.

To set post types in app, view your sub and go into the mod tools menu and use the Post types option. This option was added in the Modding on mobile - Milestone 2 update.

It's handy to know how to activate desktop mode in your mobile browser.

Following our New sub checklist, after creating your sub (name, description, type) next is:

Community topics

These aren't yet an option on the mobile app, so you'll need to use desktop (PC, laptop..), or desktop mode in your mobile browser to add these in the new reddit sidebar (top widget) or community settings under mod tools. Community settings in redesign

Rules

These can't yet be added in the official app (apollo on ios might be worth a look). Use your mobile browser in either old reddit (mod tools below the sidebar - rules), or new reddit desktop mode (mod tools button on top of sidebar - rules), or you can use this link https://www.reddit.com/r/SUBREDDIT/about/rulesJust change the sub name to yours. This rules page adds rules to your new reddit sidebar and official app 'about tab'.

For old reddit you'll need to add the rules into the sidebar (mod tools below the sidebar- subreddit settings) or link a wiki page of rules there instead. Adding rules

It might pay to have a sticky post with your main rules. Not all users look at the sidebars/about tab, though there's no guarantee they'll see the sticky either. Reaching users with information

Help

Getting new mods is much the same - Choosing new mods, and if you don't have desktop you might consider having a mod who does. Brand new subs rarely need many mods though.

You can add mods via mobile browser (desktop mode for new reddit) - Adding new mods, or use mod tools in the official app, there's a walk through of some of the mod tools here Modding on mobile.

Look and feel

Theme colour

This is another thing done on desktop/in your mobile browser (desktop mode for new reddit).

It can be set in old reddit, in community settings, at the bottom of the page in the mobile look and feel section. (The mobile banner option here doesn't seem to work anymore, see below for banners).

It can also be set in new reddit, mod tools - community appearance, colour theme (base).

New reddit overrides old reddit for the colour theme.

In app the change is subtle - only the mod tools button/join changes colour if you have graphics, if not the banner area changes too.

Banner

Making a banner is probably best on desktop/using software, but there are some websites that will resize images, remove backgrounds etc, or there is r/bannerrequest. Details and resources can be found here.

You can upload a banner on mobile, but again, only in your mobile browser at the moment.

Here's how Adding a banner on mobile

The update to the app that should allow banner uploads is planned for sometime in July this year (2020).

Icon

Your community icon can be added in the create a community workflow, but if you didn't add it then, you can add it later in app, under mod tools - avatar.

Vote icons

These can not be added in app. Again, use desktop or your mobile browser (desktop mode in new reddit) Custom up-vote and down-vote icons

Post tab

This is the main page of your sub and lists all the posts made just like on desktop, and you can sort these. (You will only see your pinned posts if sorting by hot, more here: All about sticky posts (announcements) and sticky comments)

The 'about tab'

This is populated from the new reddit sidebar, and can only be added to on new reddit in desktop or desktop mode Community sidebar (new/redesign) except rules, which can be added in old reddit (rules page) too (and on some other apps like apollo) and should automatically show up.

You should also add information to your old reddit sidebar. This shows up in mobile browsers, under a menu in the official app (community info), and probably in other apps too. Community sidebar (old/classic/legacy reddit) Remember to add your rules here or a link to them as they're not automatically added here.

Some things don't show up, or don't show properly, in the about tab at the moment, such as image button widgets, or filter by flair. Filter by flair in app work around

Menu tab

This is populated from your new reddit menu links. These are added on desktop or mobile browser desktop mode as well. Adding menu tabs (links)

More

How to change the name of your members and online users (Guess what? Desktop again!)

Post flair

Flair can now be enabled in app (ios only, android soon), previously this had to be done on desktop before you could make flair in app (as is still the case for android).

In app flair is pretty basic though, so I do recommend looking at it on desktop/desktop mode mobile browser Creating flair in redesign.

If working in app, the flair pages are part of the mod tools walk through in the Modding on mobile guide.

Automod/bots

Automoderator is best added and updated on desktop. You can do it in your mobile browser but it's small, and tricky.

Some bots are easy to add - you just add them as a mod with certain permissions and that's it, easy to do in app. Others require a wiki page which would also be tricky on a small device.

There's a group of guides on automod and bots in the index and our guide on wikis is linked below.

Seed content

Seeding content is important for new subs, our previous guide is here: How to seed content

Advertise

Once your sub is all set up you can start advertising it. Advertising your subreddit

User flair

This is much the same as post flair and the guide linked above covers user flair too.

Wiki

As with automod and bots above, the wiki is best managed on desktop. But you can try in your mobile browser. Wikis

Images in wikis don't show in app at the moment.

Modmail

Modmail in app links to a web page and is glitchy. For me, when it first loads it says I'm not logged in, or has an error. If I wait a second, most times it then works. However it's almost impossible to write a reply as the keypad covers the text box! Hopefully this'll be fixed/integrated.

You can use an RSS feed and an RSS reader app to be notified of messages.

if you know of any other work-arounds please share in comments!

---

Navigation

Image guide on some mobile modding navigation options

Image guide on modqueue and moderation buttons

In making this guide I found that crossposts seem to not have the same buttons in the modqueue?

If you can't find something in app, chances are it's not there, try desktop/mobile browser!

...

Updates to come

Reddit's roadmap for mobile app updates

Milestone 1 is done, 2 is done for ios, and 3 should be out in sometime July 2020.

That doesn't mean more advanced features for larger or more established communities won’t be created on mobile by another team or at a later date.

Things mentioned as coming later/being worked on by another team are:

  • Post Requirements submission validation on mobile

  • Rules and Removal Reasons

  • Mobile Post Requirements setup and configuration


r/modguide • • Mar 03 '21

New subs/mods How to remove a moderator, or edit their permissions

35 Upvotes

Here's a brief look at removing and editing a mod (new & old reddit, and app), and how to uninvite a mod at the bottom.

You can only edit mods that are below you on the list (typically those that joined after you, though mod lists can be re-organised in some circumstances) and if you have full permissions.

Full image guide on editing a mod here

Edit a mod in new reddit;

Go to mod tools (top of your sidebar) > moderators >

In the bottom half of the screen are the mods you can edit. Use the pencil icon next to each mod to access your options (change permissions, or remove).

If you wish to leave as mod yourself, the button is at the top.

Edit a mod in old reddit;

Go to mod tools (bottom of your sidebar) > moderators >

On the right you can use the remove buttons to remove mods, or the change buttons to edit permissions.

If you wish to leave as mod yourself, the button is in the yellow box.

Edit a mod in the official app;

Go to mod tools > moderators > editable tab >

Use the menu button to see your options (remove, or change permissions). If you cannot see any mods, use the search.

To leave as mod yourself, use the same method.

---

Uninvite a moderator

If you've invited a user to be a mod, but they haven't accepted yet, you can remove the invitation (on desktop).

In both new and old reddit, invited users are shown separately at the bottom of the moderators page.

In new reddit use the bin icon to remove the invite.

In old reddit use the remove button.

Users receive a message when they are invited as a mod and uninvited mods will still see that, but they won't be able to join.

---

Related modguide guides:

Related mod help centre articles:


r/modguide • • Nov 07 '19

New subs/mods Private, restricted, or public subreddits

35 Upvotes

(Edit: A few images in this guide will look different to how your sub looks - reddit changed the look of redesign in Jan 2020)

---

Whether your community is public, restricted, or private is up to you. You choose which as you create the sub, and you can change it later on.

Public

Public subreddits are the most common. They are open for everyone to participate in freely. You can still add users to your approved submitters list, but is is not required. It's suggested you do this for AMA guests and anyone you want to make sure can post - it's supposed to help stop their posts from ending up in spam. It may also help with rate limits.

Restricted

Restricted subs are those where only certain users can post, or comment, or both - those on the approved submitters list. But everyone else can still see the community and posts. Anyone can also comment. This can also be achieved with automod. Restricted subs can be useful for certain content types such as here at r/modguide or r/subredditoftheday.

In redesign, when you select restricted, you get a couple more options appear. This bit is ONLY in redesign, but the settings affect all iterations - redesign, old reddit and mobile.

You can select from 3 types of restriction:

  1. Post approval - only approved users can post, but everyone can comment

  2. Comment approval - only approved users can comment, but everyone can post

  3. Post & Comment approval - only approved users can post and comment (similar to private subs, but everyone can see it even if they can't interact)

Restricted communities can allow users to request to submit (via modmail/button) or turn this off using the toggle switch in the community settings, posts and comments section.

Private

Private subs are just that. Only mods and those invited can see the sub. To invite someone basically means adding them to the approved submitters list.

Users can request invites via modmail and a button to do this is shown on the sub. Uninvited users basically see a splash page informing them that the sub is private and they must message to ask for access.

Private subs are good for chatting with friends, or as a private space for mod teams. We use one to draft and review guides.

---

To see what each type of sub looks like/how to identify them, and how to change this setting in old and new reddit, see our guide here.

Consider your members when changing this on an established community.

When going from public (or restricted) to private, users who are members will still be members but they will no longer be able to access the sub (they can't see any content - posts, sidebars, wikis.. nothing except the splash page mentioned above). There is no way of seeing who is a member, or removing them. If you go back to public, these members will have access to the sub again. One reason to do this could be when giving the sub a make-over, but I would advise informing your members first.

When going from public to restricted it's much the same except your members will not be able to post (or comment, or both depending on your settings) unless added to the approved submitter list. And the reverse just opens up posting to everyone.

How to add approved submitters

Restrict posting with Automoderator

I don't know many reasons why you'd need to restrict posting with automod, instead of the in-built setting. But we do it here (at the time of writing), because we needed to link our sub with a discord channel via a bot, which in this case meant the sub needed to be public.

---


r/modguide • • Aug 07 '20

Reddit 101 How to enable 2FA on your account

33 Upvotes

It's sensible to add security to your mod accounts to help protect them, and your sub, from being hacked. Here's how:

What is two factor authentication and how do I set it up

Have your phone handy and click here for new reddit, or here for old, and follow the instructions.

I may improve on this later, but I wanted to get the information shared.

There's talk of accounts being hacked. I don't have details and I'm sure it's being worked on, but 2fa won't hurt and it's good practice for mods regardless.

More in comments! And please share your security tips if you have any :)

Edit: The admin's post has been updated. Affected mods should have access back and messages. https://www.reddit.com/r/ModSupport/comments/i5hhtf/ongoing_incident_with_compromised_mod_accounts/


r/modguide • • Mar 13 '20

Engagement Reaching users of your community with information

33 Upvotes

When users come to your community, it can be helpful to provide them information related to the topic at hand. For example, if you have a community for a TV show, it's useful to have information on where to watch it and when it airs.

Other times, something big might have happened. For example, if the community is about a video game, perhaps the release date changed and your members would really want to know about that.

There are many ways to provide such information, some of which can be repetitive. But it's important to remember different users view your community from different platforms, so one approach may stand out to them more vs other platforms. And some approaches may never reach some users.

Community Description

This is the text that describes your community. It shows up in the "About Community" widget or anywhere Reddit lists your community for others to find. This is arguably the most important information you need to give your users because it tells them what you're about!

It can only be text, no links or markdown, because the data may be shown outside of Reddit when being shared.

Community description can be edited in community settings, see mod guide: the community settings

Who Sees Community Description:

  • New Reddit / redesign users at the top of their sidebar

  • Searches for communities

  • Top of the community banner on mobile web and apps

  • Description for private communities so users know why it's private

Sidebars

Sidebars can be confusing because there are multiple instances and they are named and displayed differently on different platforms. However, the important thing to remember is different users will access your community from different places, so you want to make sure all your bases are covered.

Sidebars are useful for sharing information with your users because, at least for desktop users, it's right there on the right side of their screen whenever they visit or even open a post.

There are two sidebars you should update. One is the new Reddit / redesign sidebar, see mod guide: new Reddit / redesign sidebar / and second is the old Reddit sidebar, see mod guide: old Reddit sidebar

Who Sees the New Reddit / Redesign Sidebar:

  • New Reddit / redesign desktop users on the right side of their screen

  • Official mobile app users from the main community page's About tab

  • 3rd party mobile apps may show it, but you'd have to check the app's documentation

Who Sees the Old Reddit Sidebar:

  • Old Reddit desktop users on the right of their screen

  • Official mobile app users from the old Reddit sidebar from the main community's "..." overflow menu via the "community info" link

  • Mobile web users from the main community page's About tab

  • 3rd party mobile apps may show it, but you'd have to check the app's documentation

Menus

Menus are the links and drop-downs you can add right under your banner. You can add important information for your users there too.

While menus are only configurable via new Reddit/redesign (and displayed for mobile app users), it is possible to create menus on old Reddit using CSS.

To add/delete/modify menus, see mod guide: adding menu tabs

Who Sees Menus:

  • New Reddit / redesign users at the top of the main community page and posts that are loaded in a new tab

  • Official mobile app users from the main community page's Menu tab

  • 3rd party mobile apps may show it, but you'd have to check the app's documentation

Wiki Pages

Reddit allows communities to enable and create their own wiki pages. You can use them for whatever you want, but they are especially useful because you have more space to go into more details. While other options tend to be shorter (because you don't want to overwhelm your users), you can link from there to specific wiki pages to give more detail on the subject in question.

Other uses for wiki pages include archives of featured posts, more detailed rules, frequently asked questions (FAQ) about your community and/or the topic of it, larger community directories, and many more.

To create or edit wiki pages, see mod guide: subreddit wikis

Who Sees Wikis:

  • All users from wherever is visible to them that you linked to wiki pages

Sticky Posts

Community moderators can pin up to two posts to the top of their main community listing page. That means they can control the first post (or posts) users will see upon visiting them.

Common use cases are a welcome post, a featured mod post, an announcement about changes to the community, an announcement about the topic of the community that members wouldn't want to miss, and many more.

Mods can sticky their own posts or posts by any of their members, see mod guide: sticky posts and comments (aka announcements)

Who Sees Sticky Posts:

  • All users who sort the community page by Hot (default sorting)

Sticky Comments

Similar to sticky posts, mods can pin a single comment within a post so that users always see it first.

Mods use sticky comments to give reminders about the rules (especially if the post is going off the rails), indicate sources of artwork or references, clarify misconceptions, and many more. Also, some communities use AutoModerator to automatically add a sticky comment to all posts (or some subset).

Mods can only sticky their own comments, so if they need to sticky information a non-mod commented, they'd have to enter the info in a new comment and give credit to the other use. See mod guide: sticky posts and comments (aka announcements)

Who Sees Sticky Comments:

  • All users who load the post, regardless of how they sort the comments

Live Posts

Reddit Live is a feature where you can make real-time updates, that refresh automatically and can do so in coordination with fellow contributors.

Live posts can be useful if your community deals with something that can have a lot of new information released at once. For example, a video game release, a big developing news story, or even details on the latest superhero film!

Click here to see the announcement of Reddit Live feature

Click here to create a new live post

Frequently asked questions (FAQ)

Who Sees Live Posts:

  • All users from wherever is visible to them that you linked to the live post

Welcome Messages

Welcome messages can be configured for your community so that new members get a pop up and a message sent to their inbox after they join.

(Pop ups only shown if welcome message is not over 500 characters)

What better way to let them know the basics and helpful tips than when they first get there? See mod guide: how to create a welcome message

Who Sees Welcome Popups:

  • Users who join your community will get a pop up if the message is not over 500 characters

Who Sees Welcome Messages:

  • Anyone who joins where a welcome message is configured. Within an hour, they will get a message in their inbox

Notifications (In Alpha Test)

There aren't a lot of details about how this feature will ultimately work yet, but the gist is that moderators of a community can send a message and everyone who has joined the community will receive it in their inbox. It's like the welcome message, but you can send out an updated announcement for any changes, or big news, or anything you deem relevant.

This is currently only available to communities who have signed up and been chosen for testing the feature.

Click here to see the announcement of notification feature test

Who Sees Notifications:

  • Anyone who joined your community where the notification was sent. They will get a message in their inbox

Related Resources


r/modguide • • Feb 13 '20

New subs/mods How to change your community type (public, private, restricted) and 18+ setting

33 Upvotes

How to change your community type in redesign and old.reddit

To go straight to your community settings you can go directly to https://www.reddit.com/r/SUBREDDIT/about/edit/ (change SUBREDDIT to your subs name / old. or new. to specify old reddit or redesign) or follow the guide below.

Public subs are open to all, restricted subs only allow approved submitters to post/comment/or both, and private subs are private only allowing those invited to see the sub. More details below in the linked guides at the end.

Alternative imgur guide for those on old reddit

---

In redesign - Go to mod tools at the top of your sidebar.

Then select community settings in the mod tools list.

Under community type, select whichever you want.

You can set/change your NSFW/18+ setting here too.

In redesign, when you select restricted, you get a couple more options appear. This bit is ONLY in redesign, but the settings affect all iterations - redesign, old reddit and mobile.

You can select from 3 types of restriction:

  1. Post approval - only approved users can post, but everyone can comment

  2. Comment approval - only approved users can comment, but everyone can post

  3. Post & Comment approval - only approved users can post and comment (similar to private subs, but everyone can see it even if they can't interact)

Restricted communities can allow users to request to post (via modmail/button) or turn this off using the toggle switch above.

Hit save changes, top right.

---

In old reddit go to mod tools at the bottom of your sidebar and select subreddit settings

Scroll down to type and select whichever you want. If you want more control over who can post and comment, see the redesign settings instead (above).

Scroll down a little to 'other options' if you need to change your NSFW/18+ setting - it's the first check box.

Hit save at the bottom.

---

Related guides:

Thanks u/majorparadox, u/sunzusunzusunzusunzu


r/modguide • • Jan 14 '22

Bots How to run a basic python script for reddit from your computer. | Announcing the r/ModGuide Scripts Library.

32 Upvotes

Introduction

Let's say you wanted to add a sidebar widget to your subreddit with a list of related communities. There's actually a couple of ways to do this. You could login to your account, navigate to the mod tools in your browser and add the widget normally or you could add the widget via a simple python script.

Scripts have a high barrier to entry because you need special software to work with them and special knowledge to write one. However, once you know how to run one, they are very easy to work with. Scripts allow you to do things on a subreddit, such as adding a sidebar widget, much faster than the traditional way. The special software you'll need to run a basic script are two items called Python and Praw.

Python is a software language and Praw is a module that facilitates communication with reddit. More info on this follows below.

Note: This post is not all-encompassing. It won't teach you everything you need to know about scripting, Python, and Praw. The point is to get you up and running quickly so that you can run a simple script you found online or from our scripts library. Once you become comfortable with scripting, you can explore more advanced options.

What is a script?

A script is a text file with a set of instructions specially formatted using a specific syntax which is interpreted by a program (python) and applied to an object, for the purposes of this post, a reddit object. There are 6 reddit objects you can work with: comment, post, message, redditor, subreddit, and award. Each object has what are called attributes which can be evaluated or changed by your script. An attribute of a comment might be its score, or the subreddit it is posted in. Other attributes are true/false, such as is this post spoiler formatted?

Scripts are run on a desktop/laptop computer via the command-line interface. On Mac, this app is called the Terminal. On Windows, it's the Command Prompt or the PowerShell. The command line is a program to give the computer written instructions as opposed to clicking on a file or program on the desktop in order to run it. To open the PowerShell, click Start, type PowerShell, and then click Windows PowerShell. On Mac, search for the Terminal, or navigate to your Applications folder and open the Terminal application.

Changing an attribute on an object can be very simple. When you approve a post, you switch the attribute on the post Approved: False to Approved: True. Changing an attribute of a subreddit could be setting it to private. In this post, we'll be changing an attribute of a subreddit object, ie adding a sidebar widget.

When you use a script, your computer connects to Reddit via something known as an API instead of a browser window or a mobile app. Reddit's API is complicated so we're going to need a "shorthand" to make communicating with it easier. This "shorthand" is called Praw and it's a Python module that you will need to install on your computer. Praw is for working with Python; there are other modules for working with other languages such as Javascript.

Modules are kind of like browser extensions. They give python special capability. If you wanted to work with an Excel spreadsheet, you'd need a python Excel module. Think of the requirements for reddit scripting as the three Ps: Python, Pip, and Praw.

The Three Ps

To run any python reddit script or bot you'll need the three Ps: Python, Pip, and Praw.

  • Python is a computer language that interprets the instructions in a script and applies them to an object.

  • Pip helps you install software modules needed for your script.

  • Praw is a module for working with python and reddit's API.

The latest version of Python is 3.10. However, as long as you are working with version 3.7 or newer you'll probably be ok. The current version of Praw is 7.5. This guide won't explain how to work with earlier versions of python or praw, or scripts that rely on older versions of them.

If you don't have python on your computer, get it here:

Note: Avoid installing python from the windows app store as you could get the wrong version or it won't be added to the path which could cause problems.

Check your version of python. Open up a Terminal or PowerShell window. Type the following then press return. (This is an optional step and not required.)

  • Windows: python3 --version

  • MacOS / Unix: python3 --version

Pip is part of the python software. If you want to confirm that you have pip installed, open up a Terminal or PowerShell window. Type the following then press return. (This is also an optional step and not required.)

  • Windows: pip3 --version

  • MacOS / Unix: pip3 --version

Since we're using python 3, we'll be using pip3.

The version of pip in the screenshot is 21.2.4, and the version of python is 3.10.1.

Installing Praw via Pip

Once we have python installed, we'll install praw with pip. Open up a new Terminal or PowerShell window and install praw by typing the following command and pressing return:

Mac OS/Unix:

  • pip3 install praw

Windows:

  • pip3 install praw

Pip will run for a minute or two while it installs Praw. Once Praw is installed you'll be one step closer to running your script.

Getting your script credentials

To run a script you'll need your reddit username and password of course, but you also need a special username and password known as the Client ID and Client Secret.

You have to generate this information in your reddit account preferences. If you are running the script on your own account go there, otherwise go into the preferences of the account on which you want to run the script.

In your account preferences, look for 'Manage Third-Party App Authorization'.

Follow these steps to get your credentials.

  • Go to your account preferences.

  • Click Create App.

  • Name the app.

  • Important: Select "script" from the selction buttons.

  • Description: Give the gist of what the script does.

  • About URL: If you don't know what this is you can leave it blank.

  • Redirect URL: Put this: http://localhost:8080.

  • Click Create App.

  • Make note of your Client ID and Client Secret. Don't post them, keep them secret.

Logging in with a Script

A script needs to login to reddit just like any other account. You can be logged in to reddit on your account and run a script on that same account. Once you've created a script app in your preferences, you'll need to copy-paste the login credentials into your script file. Since this is a basic tutorial we'll paste our login credentials right into the same file as the script as opposed to storing them in a separate config file. Storing login credentials in a separate file is described here.

Note: If you're using 2-factor authentication on the account you are using for the script, you'll need to include your authentication code with your password in the password field like this: password = "PASSWORD:SIX_DIGIT_CODE" For example, password = hunter2:123456. Once you save the file with the authentication code included, you must run the script before the authentication code expires.

The following standardized code block is known as the reddit instance. It logs you into reddit, then assigns your login to the word reddit, known as a variable.

import praw

reddit = praw.Reddit(
    client_id="CLIENT_ID",
    client_secret="CLIENT_SECRET",
    password="PASSWORD",
    username="USERNAME",
    user_agent="USERAGENT"
)

This will be part of each script and you will need to replace each CAPITALIZED PHRASE in the above code snippet with your own login credentials.

For CLIENT_ID and CLIENT_SECRET, paste the information from your app creation page. The user_agent field is important. The more descriptive the better. It should include the following info:

  • The name of the script

  • the author

  • the version number of the script

Here's an example of a good user_agent for the example script below:

Sidebar Widget Moderation Bot for r/Ask v1.0 by u/BuckRowdy

Note - Never post the script login information publicly. If you share the script with someone, delete the login info beforehand. Most people keep the login information in a separate config file which makes sharing scripts easier. Instructions on how to do that can be found here.

The first part of the script is the reddit instance. The rest of the script consists of the instructions needed to carry out the script. Let's look at an example.

Adding a Related Communities Widget to your sidebar.

The following script was adapted from the Praw documentation.

This script adds a related communities widget to r/ask. You can also view this script here with line numbering.

1    import praw
2
3 
4     reddit = praw.Reddit(
5                         client_id="CLIENT_ID",
6                         client_secret="CLIENT_SECRET",
7                         password="PASSWORD",
8                         username="USERNAME",
9                         user_agent="USERAGENT"
10                        )
11
12
13
14    sub_name = "ask"
15    widget_title = "Ask Communities"
16   
17
18    widget_moderation = reddit.subreddit(sub_name).widgets.mod
19    styles = {"backgroundColor": "#f6f8ff", "headerColor": "#0000e9"}
20    subreddits = ["askreddit", "ask", "askhistorians", "askculinary", "askscience", "askdocs", "askmen", "askwomen", "askuk", "trueaskreddit"]
21    new_widget = widget_moderation.add_community_list(
22    widget_title, subreddits, styles)

Walking through the script

Let's walk through the script and see what each part does. Line 1 imports Praw. Modules must be imported into your script so you can work with them.

Lines 4-10 are your login credentials.

Line 14 defines the subreddit you are working on and Line 15 defines the title of the widget. Note: when working with subreddit names, the "r/" part is not included.

Line 18 sets up part of the command to add a new widget and assigns it to the variable widget_moderation. Line 19 defines the header and background color. To change these values, paste in a hex color code. Line 20 defines the list of related communities. The format is similar to a list of items in your auto code; brackets around items in quotes separated by commas. Line 21 - 23 consists of the rest of the praw syntax to add the new widget. The first part of the syntax was assigned to a variable in line 18. When adding the bit from the variable in line 18, the full command reads: reddit.subreddit(sub_name).widgets.mod.add_community_list().

When you add this type of widget, you need to pass specific information which is defined in lines 15, 19, and 20. Lines 21 & 22 pass that information to the add_community_list() function.

A related communities widget can contain up to 10 subreddits. You can add a widget with fewer than 10 items in the list, but more than 10 will cause an error. If you need a list longer than 10 items you should make use of multiple widgets.

How to actually run the script

Scripts are text files with a .py extension on the end instead of .txt. You can open them and edit them in any text editor, but code is generally written and edited with a special text editor or an IDE. Then the code is executed or run in the Terminal or PowerShell.

Once you have python and praw installed and you have your script on your computer, actually running it is really easy. In the Terminal / PowerShell, you type the name of the application (python) followed by the file to run, then press return.

Note: You'll find there are various ways to accomplish this including changing directories to the folder where the script is stored. But we're keeping it simple in this post, so we'll use the full file path.

To tell the computer what file to run, we'll need the precise location of the file, known as the file path or path and will be in the form of a folder structure such as

  • Mac /home/users/myself/docs/scripts/add_widget.py or

  • Windows C:\Users\myself\Documents\Scripts\add_widget.py

If you need help with finding the file path, see here: How to find File path - Windows | How to find file path - MacOS.

Once you have the file path, you'll need to run the file in the command line. Open a new Terminal or PowerShell window and run the file with python by typing the following:

Mac OS/Unix: python3 /home/users/myself/docs/scripts/add_widget.py

Windows: python \Users\myself\Documents\Scripts\add_widget

If everything is configured correctly and you've made no mistakes, your script will run and finish without errors. It shouldn't take more than 2 seconds to execute the script.

If an error occurs the script won't finish and you'll have to resolve the error before trying again. Don't worry, there's probably an easy solution to what caused the error. Look at the error message output that was printed in your terminal. Copy the error message and google it. You should be able to find a solution pretty quickly. If you need to ask someone else to help you resolve an error, make sure to copy-paste the entire output so that they can see what the error was.

If there are no errors, congratulations, you just added a related communities widget to your sidebar!

Here's the example from r/ask.

Other Sidebar Widgets

Adding a sidebar widget is an example of one of the most basic things you can accomplish via scripting. Bots and scripts can be very simple or very complex depending on the desired outcome.

The Praw documentation provides examples for adding other types of sidebar widgets that you can adapt for your community.

Script snippets in the praw documentation will use the same reddit login code like the above script.

Scripts can be found online in various places such as r/redditdev, r/requestabot, Github, or even StackOverflow. You can learn to write one or ask someone to write one for you. The sky's the limit (and the reddit API) to what you can do via reddit bot scripting.

Announcing the r/ModGuide Scripting library.

r/Modguide maintains a vast amount of resources in our wiki. The Automoderator Snippets Lbrary and the CSS Snippets Library provide pre-written code that can drop into their config as-is.

Today we are launching a third library for reddit API scripts. We'll gather and post basic scripts in our wiki here. If you'd like to contribute a script, please Message the Mods.

Good luck!

Other Resources:


r/modguide • • Aug 05 '20

Reddit 101 How to modmail

32 Upvotes

This is a resource guide for moderators to share with users as required, with a few tips for mods thrown in!

How to send a message to moderators of a subreddit

All communication with mods relating to their subreddits should be done via modmail. Please DO NOT private message moderators.

Many mods have felt the need to turn off private messages (PM's) and chat due to users sending messages this way. Modmail is designed for communication regarding a sub and it's moderation, and allows all mods with the mail permissions to see the conversation, as well as including some mod tools. You're not likely to gain anything by sending PM's.

The modmail button can be found at the bottom of the subreddit sidebar.

In new reddit (redesign) the button is in the header of the moderator list widget. It is a mail/envelope icon.

EDIT: This has been changed as of late Sept 2020. It's now a larger, more obvious button, just below the moderators title, and above the list of usernames. This is on desktop, but not mobile app at the time of editing.

In old reddit (classic/legacy), it's the text 'Message the moderators' next to the title of the moderator list.

Edit: This has changed too. It's now a larger button at the top of the moderators list box.

In the official app it's a mail/envelope icon in the header of the moderator list, at the bottom of the information in the 'about' tab.

Edit - Or (thank you u/Rhamona_Q) you can use the three dots/menu button top right when viewing a subreddit, where you'll see a 'contact mods' option - bit quicker than finding it in the 'about' tab. (3rd party apps are likely to have some sidebar or information button or menu with an option to modmail too)

Once you've pressed the button, proceed just like sending a private message - fill out the title and text boxes and press send.

---

On desktop you can also open the message form by pressing the 'send a message' button on a user's profile (PM), but then changing the To field to the subreddit's name (include the /r/), so if you start to PM and then remember it should be modmail you don't need to navigate away, just change the To field.

---

Tips for users:

---

Tips for mods:

  • Add a more prominent modmail button. In new reddit you can use a button widget, or an image widget to create a new modmail button. In old reddit markdown and CSS can be used. For mobile a text button in the button widget is best as image buttons don't show up, and image widgets separate out the link on mobile.

  • Consider mentioning modmail in your welcome message

  • Consider mentioning modmail in your welcome sticky post

  • Perhaps add a link to your menu tabs

  • If you use old modmail on mobile it may look like a user has PM'ed you when they have actually modmailed - check that isn't the case before you take action

Example modmail buttons

If you have examples, button images, or CSS code you're willing to share, please pop it all in comments. Thanks!

You can get the modmail link by clicking the modmail button and copying the url, or use this and change the subname:

https://www.reddit.com/message/compose?to=/r/Subname

Related guides:

Thanks to u/epicmindwarp and this thread for the inspiration.


r/modguide • • Jan 25 '20

Engagement Getting Subreddit Statistics - why, where, and how!

32 Upvotes

Okay, so you've spent some time to make your subreddit look nice and spiffy, and you're starting to build a community of people around its subject. There are new submissions and comments coming in, and subscribers are growing by the day. You and your fellow mods want to plan ahead and figure out how to expand the subreddit and be responsive to the needs of the community.

But in order to go forward, you must know how far you've come..

Author disclaimer: I am the writer and maintainer of u/AssistantBOT, which is one of the statistics tools listed in this article.

Why get statistics for your subreddit?

By gathering information on your community, you can better assess its health and the types of content that are most popular within it, see which users are most engaged, and track your subreddit's growth over time and prepare for future growth. In this article I will share and discuss various tools by which you can get useful statistics for your community.

To a certain extent, having statistics also allows you to make data-driven decisions about what to do, and combine both intuition with facts that you can use. Also, it's just kinda fun to see and track!

Where and how can I get useful statistics for my subreddit?

There are actually not that many sources for statistics, but together these tools should allow you to gain some insights. There's no need to limit yourself to just one source of statistics, you'll find that all of these tools have their strengths at coverage.

AssistantBOT

u/AssistantBOT, full disclosure - this is my bot. I wrote it to fill what I saw as a void for granular subreddit statistics, especially about the types of posts that get posted to a community. It is a very broadly used bot by over 650+ subreddits, so clearly people do find it useful.

The statistics routine of AssistantBOT updates a wiki page every day with the following information:

  • A monthly statistics breakdown of your community's posts and its activity (most active days, top submitters/commenters, top-voted posts).

  • Daily subscriber growth, both future and historical, as well as past and future subscriber milestones.

  • Traffic data, including the average uniques and pageviews for your community and its estimated traffic for the current month.

  • A breakdown of the userflairs of your community and how many people have each userflair (optional).

You can see a list of public AssistantBOT statistics pages as an example in the sidebar of r/AssistantBOT on New or Mobile Reddit, or just visit r/ClassicWOW's statistics page or r/BoxOffice's statistics page for examples.

For AssistantBOT to track subreddit statistics it must be invited as a moderator with at least the wiki mod permission - further details can be seen in the introduction post.

SubredditStats

SubredditStats is a freely open site that allows you to do the following:

  • See graphs of subscriber growth for a subreddit over time

  • See how your subreddit stacks up to others in terms of key activity metrics.

  • See cumulative top posters, top scorers, etc.

Another cool thing is that you can also compare the subscriber growth between several subreddits in graph form to see how they've grown over time. The site will also note related subreddits by keyword which can allow you to see other subreddits that you could possibly work with or cross-promote.

r/subreddit_stats

r/subreddit_stats is u/bboe's project - he wrote PRAW, which is the API wrapper that the vast majority of Reddit bots use. Information from the bot that powers this subreddit is obtained by making a post according to these rules and then the bot will create a post in the subreddit with various information metrics.

Here's one example, with the results generally limited to the last 1000 posts due to limitations of the Reddit API. You'll be able to see the top submissions, the top commenters, the top submitters, and also the top comments.

RedditMetrics.com

RedditMetrics basically does one thing and one thing only - it tracks subscriber growth for subreddits, and you can see how your subreddit has grown over time and also see how it compares to others in graphical form. It is also the basis for information for both AssistantBOT and SubredditStats.com when it comes to early subscriber information and due to its longevity it's been a longtime mainstay of Reddit moderators' toolkit. They're also the site that powers r/TrendingReddits.

One caveat: RedditMetrics was down from March 2018 to June 2019, and the site has filled in those dates with dummy data where the growth rate is constant and not actually reflective of the daily movement of subscribers. So do not take the growth rates recorded during that time as gospel, as they are certainly wrong even if they reflect an average growth.

Redective

Redective is an older site that gives you some interesting results, like most used words and the most active hours of your community.

Should I share statistics data with my community?

I'm a proponent of sharing statistics data with fellow members of the community. People generally like seeing statistics, and statistics may also give regular users a better idea of the challenges and the issues the moderator are dealing with.


Know of any other statistics tools? Feel free to share them in the comments!


r/modguide • • Dec 05 '19

Mod Pro Tips Doxxing

32 Upvotes

Doxxing is where a user publishes private or identifying information about (a particular individual) on the Internet, typically with malicious intent. This is totally and absolutely against Reddit’s rules. Doxxing can include revealing a users real name, email address, home location, or any other identifying information.

If you see this within your sub you must immediately remove the comment, ban the user and report them to the reddit admins - the easiest way to do this is to send a modmail to r/reddit.com - the sub is inactive but the mod mails are read by the admins of the site.

Doxxing can be very very dangerous and there have been a few instances in reddit where it has caused serious harm and damage to users. For example:

https://en.wikipedia.org/wiki/Sunil_Tripathi - boston marathon bomber

https://www.reddit.com/r/TwoXChromosomes/comments/1ap0a0/i_was_doxxed_about_one_year_ago_and_i_am_losing/- user who had naked pictures, name, address released online

https://gawker.com/5950981/unmasking-reddits-violentacrez-the-biggest-troll-on-the-web - one of reddits biggest trolls doxxed and subsequently lost his job

Looking at the above links you could make the case to say one of them “deserved it”. The problem is that there is no safe line of when it is acceptable to doxx and when it isn’t.. One may say it is fine to doxx a peadophile or a teacher having a relationship with a student. Others will disagree. There is no way to predict or see the potential consequences of doxxing. Once the information has been released and viewed by others there is a very real potential for harm to be done. The easiest and the only way to protect our users is a total and absolute 0 tolerance policy.

As mods we have to enforce that doxxing is never and will never be acceptable on any of our subs. Our users are real people, with real lives and feelings and families. Go and look on subs like r/AmItheAsshole or r/OutoftheLoop and many many others and you will see people asking about whether they should doxx someone else or about people who have been doxxed or the events that that happened after someone has been doxxed, whether from reddit or from another forum / social media or a news site.

Unfortunately doxxing isn’t that difficult. If you have an hour and google then it is pretty likely that you would be able to doxx someone. As the genius Ian Malcolm said; “so preoccupied with whether or not they could, they didn't stop to think if they should.”

Yes there are some circumstances where looking someone up and contacting the relevant authorities may be required but releasing their information on the internet never ever ever will be.

There is a report form here - https://www.reddit.com/report?reason=its-personal-and-confidential-information - to send the report to the reddit admins if you are being doxxed or if you see it happening to someone else where you are not a mod

To help keep yourself and your users safe it is really worth checking out:

r/privacy

r/privacytoolsIO

r/OPSEC

r/redditsecurity

Try to ensure you avoid using your real name on social media accounts, especially those that have a connection to your user name. Use different user names on different platforms and be careful what personal information you post.

Remember that as mods you are more likely to be doxxed, especially in situations where you have banned or had a disagreement with a user. This can often be accompanied by threats, please do not hesitate to contact reddit using the above form about them, as well as considering contacting your local police force about threats being made to you.


r/modguide • • Jul 22 '20

Mod news/updates The new scheduled posts feature is rolling out - Automod scheduler to be deprecated

Thumbnail
self.modnews
31 Upvotes

r/modguide • • Oct 18 '19

Congratulations, /r/ModGuide! You are Subreddit Of The Day!

29 Upvotes

r/modguide • • Jan 19 '21

Bots Do I need to invite u/automoderator as mod?

28 Upvotes

tl:dr = no ;)

To use automoderator to help moderate your subreddit

YOU need 'wiki' and 'config' permissions on the mod account you are using, but automoderator doesn't need to be added.

To post as automoderator using the new post scheduler

For the new/redesign post scheduler, Automoderator will need 'post' and 'flair' permissions, but you don't need to worry about adding it!

Automoderator will be automatically added as mod, with the required permissions, when you schedule your first post to post as automoderator.

---

Other moderation bots typically require adding as mod, but automod has become part of reddit itself, and so is different.

Bots

---

Don't forget, if you have any ideas for guides you can Suggest a topic :)

NEW Our master list of AM resources


r/modguide • • Jun 16 '20

MG Mod post 100 guides posted!

28 Upvotes

Big thank you to everyone who has contributed to r/modguide in any way; you help make the sub the resource it is. Hopefully it helps, and will continue for a long time yet!

If you’d like to help:

  • We have some surveys linked in the sidebar and menu tabs, particularly this one on the help you needed when you first started modding - it’s been a while since we’ve had respondents, so if you haven’t filled it out please do. It might be interesting to see how the answers we get now, compare to our last round of answers.

  • All the surveys are here, including an anonymous feedback form - we welcome all constructive feedback.

  • Suggest topics via modmail.

  • If you’re interested in writing, send us a modmail, we'd like to see your work. We’re friendly and we all help each other check and polish our guides before they go out.

  • If you are a mod who has called in the mod reserves, or if you have been a reserve mod, we are interested in your thoughts and take-aways from that experience - please modmail if you’re happy sharing. There might be a useful guide or two we can build up for the future.

  • Continue to comment on, and link, the guides.

We’re curious to know which guides you have used, and how things worked out. Please let us know!

Thank you

Happy modding!


r/modguide • • Feb 01 '20

Discussion thread Actioning users based on activity in other subs

28 Upvotes

Actioning users based on activity in other subs

Sometimes a situation might come up where you find yourself deciding on whether to ban someone from your sub, based upon their actions in other subs.

This is what Reddit says:

“We know management of multiple communities can be difficult, but we expect you to manage communities as isolated communities and not use a breach of one set of community rules to ban a user from another community.”

Ultimately this is going to be your/your mod team’s decision taking into consideration what the user has done, the severity of their actions and its impact, morality, fairness, etc.

This subject is controversial. In this post we simply aim to help you make an informed decision.

There are some compelling reasons you might do it:

  • To protect your community from scammers (for which you could choose to use the USL/Universal scammer list).

  • To protect your community from participants of hate subs, and trolls (you could use r/masstagger to do this - there is white-listing. Also RPT).

  • It’s an annoying bot (r/botdefense and r/botterminator are both anti-bot bots)

  • Stalking and harassment.

  • Brigading.

  • User is already on the fence and viewing their behavior elsewhere can indicate whether it is a pattern (for example: a comment in your sub sounds like it could be racist, but you’re not sure. Seeing that they are making lots of racist statements all over Reddit tells you it was most likely racist).

  • Mods are volunteers and so you might decide to do what makes your life easier.

But you should consider:

  • Context matters: Someone on a "bad" sub might only be there to try and mediate, or change opinions etc and not engage in any badness, but could end up banned and tarred with the same brush as everyone else.

  • A users behavior may be different in different subs.

  • Are you using your position to your advantage?

  • Fairness.

  • Not banning users from unrelated subs for breaking one sub’s specific rules.

  • Alternatives to banning based on actions elsewhere; perhaps less warnings before a ban if there is a pattern of behavior instead.

Admin quotes:

I can't ban a spammer across multiple subreddits until they participate there?

“I think the ideal is that we are not being pre-emptive with bans. I would rather that people were only being banned from communities where they were active, and not from communities they have never visited. However, it's a bit different when we're dealing with a fully automated spambot. We don't want you pre-emptively banning 'people', but I don't have a strong feeling about protecting a bot's feelings.”

If I mod two subreddits that are very similar. I can't ban from both when they attack users in one? (same thread as above)

“I'm still working out the details, but I hear what you're saying, and I'm designing enforcement standards to take that into account. I haven't locked it in yet, but at the moment I'm thinking that we'll be looking at "close networks" of subs as a single sub for this purpose. So in your case, because the two are closely affiliated, likely share a mod team, etc, I wouldn't have a problem with a ban across the two. But two totally dissimilar subs, even if both are modded by you, would not qualify for that exception...”

Are mods allowed to blanket ban users across their whole moderation portfolio motivated by the action the user took in a single community?

“This is a fairly complex issue and as others have mentioned this really depends on the context of each situation, but these are typically issues we review under the mod guidelines. Speaking from the viewpoint of community health, one of the most important aspects is that moderators are maintaining a reasonable appeals process. Again, context of the situation is important, but there are cases where we do reach out to mod teams, especially if there's a pattern of behavior detrimental to the community.”

Some mod discussions on the topic:

---

Thanks to u/majorparadox, u/juulh, u/BuckRowdy. Suggested by u/dan6erbond

What do you think?


r/modguide • • Dec 09 '19

General What if I don't want to mod anymore?

28 Upvotes

If you no longer wish to moderate a subreddit, here's what you can do.

If it's your sub/you're top listed mod

Subs cannot be deleted, so ideally you'll pass your sub on to someone else.

  • If there are other mods on your sub, you can make sure someone has full permissions and then leave. Ideally you'd talk with your mods first. The mod list is hierarchical so if you're top mod the next mod down becomes top mod when you leave.

  • If you are a lone mod, you can find someone to adopt your sub, perhaps at r/adoptareddit. Add them as mod with full permissions, wait until they've accepted, and then leave as moderator.

  • You can also find people to mod at places like r/needamod.

  • You can "close" your sub by making it private, and leave as mod too. This isn't a sure fire way of "closing" it forever, as someone could request it on r/Redditrequest.

  • You can simply leave as mod - if you were the only one, or if the other mods are inactive, your sub will now be unmoderated. In rare cases, without moderator oversight, some subreddits' users may start breaking the content policy and quarantine criteria, thus resulting in a quarantine of the subreddit. Unmoderated subs are able to be requested by others at r/redditrequest, but there is no guarantee anyone will.

  • If you created the sub it will always say 'created by yourusername' unless you delete your account, then it will say 'created by [deleted].

If you're not top listed mod

  • You can just leave. Ideally you'd talk with the other mods first. Make sure someone has full permissions if you can - typically top mod already will have, but not necessarily.

  • If you were the only active mod, and have permissions to add new mods, you could find someone else to take over. r/needamod

How to leave

To leave as mod in redesign: Go to mod tools button (top of sidebar), moderators, and hit leave as mod at the top - only do this if you're sure!

Or in old.reddit go to the mod tools list (bottom of sidebar), moderators, and hit leave at the top - only do this if your're sure!

---

Edit:

In app

Mod tools - moderators - editable tab - the three dots by your name - remove

Image guide here

---

Related guides:

Big thanks to u/MFA_Nay


r/modguide • • Jun 23 '21

Bots Helpful moderation bots

27 Upvotes

The wonderful u/001Guy001 has put together another wiki page for us, this time a curated list of helpful mod bots that builds on, and complements, our previous bot guides.

See the page here

This page has been added to our indexes.

Previous guides:


r/modguide • • Feb 06 '21

MG Mod post Yey, 2K!

27 Upvotes

We've just hit 2,000 members :)

Thanks for joining us everyone. Have you got any questions for us?


r/modguide • • Nov 24 '19

Tools Distinguishing Moderator Comments and Posts

27 Upvotes

Distinguishing a comment shows that a moderator is commenting or speaking as a moderator, officially, for the subreddit and the moderation team, not as a normal user on Reddit. You normally distinguish a comment when you want it to be official, whether it’s a warning, an apology, a clarification or an explanation for a mod action. You can speak as a mod without distinguishing your comment, but it usually looks a bit more informal and will probably reflect poorly on you or your sub if you aren’t giving official warnings and then taking mod actions.

A distinguished comment looks slightly different. It gives a mod shield after the poster’s name and turns their username green.

There are a few situations that distinguishing comments is helpful. Distinguishing comments and posts is a way to differentiate between when you are acting a mod and when you are participating as a user and community member. (More on participating in a community as both a user and a mod later!) When you remove a post it's a good move to leave a distinguished comment with the removal reason in it. When you warn someone that a rule is being broken, a distinguished shield shows you're speaking formally.

One thing - don't distinguish anything you wouldn't want to be held to, and make sure your mod team agrees on removal reasons and rule enforcement so that distinguished comments are clear and don't contradict each other.

Distinguishing a comment does not send any additional notifications to the person you're replying to. They get a notification that you have commented on something they wrote, but nothing about it being official or distinguished.

Here is our guide with screenshots of examples of distinguished comments and posts, as well as visual steps on how to do so on desktop and mobile.

How to distinguish a comment:

If you aren't in mod mode, click the shield with the star inside, to the right of the shield with the lines. If you are in mod mode, click the shield with the star inside to the right of the lock icon. Select 'Distinguish as Mod' or 'Distinguish and Sticky' - whichever is best for your needs.

To distinguish a comment on mobile, click the grey shield above the comment section, under the post. When you click or tap the star shield you have two options: 'Distinguish as Mod' or 'Distinguish and Sticky'.

How to distinguish a post:

You can also distinguish posts. This is very helpful when combined with stickying a post for your community. This one doesn't matter whether you have mod mode on, Just click the shield with lines in it and you can sticky the post and/or Distinguish as Mod.

To distinguish a post on mobile, click the grey shield right at the top of posts to enable. You will then see the little shield with the star inside below the posts. The star shield will distinguish a post, the little menu icon next to it will sticky it.

Huge shoutout to u/SolariaHues for the mobile screenshots.


r/modguide • • Oct 14 '19

Engagement My personal philosophy on dealing with problem users, user communication, and escalating discipline.

27 Upvotes

Hey there, r/modguide. I would like to discuss my personal approach when it comes to dealing with problem users and escalating discipline.

For the purposes of this post we must assume that the users we're talking about are good faith users. Bad faith users require a different approach and a separate post because they cannot be actioned in the same way. Bad faith users try to disguise themselves as good faith users and it will be hard sometimes to discern the difference. Until you've learned how to make that determination it's a good idea to approach each user as a good faith user. Make use of the provided tools to help you keep track of users.

I would like to discuss my personal philosophy when it comes to dealing with problems with users including progressive discipline, when to ban a user, & best practices on user communication.

Each subreddit has its own personality and culture and there is a wide array of them on reddit. Many of my subs are discussion based and do not see many image or link posts. Users in those subs get to "know" each other through long conversations with long blocks of text, putting themselves and their opinions out there for criticism.

Any time you put your opinions out there you open yourself up for criticism from others. Criticism can lead to users antagonizing each other leading to fights. In those subs I moderate users' tone not their opinions. They must make their points without insulting and antagonizing other users. Users should attack the argument not the user. See [Graham's Hierarchy of Disagreement for more.](https://en.wikipedia.org/wiki/Paul_Graham_(programmer)#Graham.27s_hierarchy_of_disagreement)


When I'm moderating a user my primary overarching goal is: How can I prevent this user from turning into an angry one who will either:

  • a. create their own sub as a platform to criticize and trash the mod team, or;

  • b. spend a year harassing me through various accounts. Sometimes you cannot prevent it and there are circumstances where you might want to encourage a user to go through with creating their own sub.

I use a progressive discipline approach starting with the lowest level action required and then escalating discipline as the problem escalates. You do not need to use a sledgehammer to kill a fly.

Reddit itself provides a framework in it's content policy which shows they take the same approach. The steps they follow are:

  • Asking you nicely to knock it off

  • Asking you less nicely

  • Temporary or permanent suspension of accounts

  • Removal or restriction of posting privileges

This system allows for flexibility while providing a structure to improve consistency in enforcement.

Any of these steps can be skipped depending on the severity of the infraction. Indeed, bad faith users can "go directly to jail; do not pass go, do not collect $200".


I participate in the communities I mod and I try to build credibility as a user by contributing quality content and being a quality commenter. Keep in mind that everything you do on a sub you mod is viewed through a different lens and you'll be held to a higher standard.

As a general rule, it behooves you as a mod to be calm, fair, consistent, and to listen to users as much as the situation allows. When most users complain, they want to know that you are listening to them and that you are considering what they have to say. Building consensus on a sub is important and if you can get users to invest in the sub then users will make your job easier by reporting violations.

Sometimes users in a discussion get carried away in the moment and when things start to go off the rails, I will generally start with a reply such as "Can you please make your points without resorting to insults?" Good faith users generally have a good response to a reply such as this because you are not trying to censor their opinions, rather you're trying to get them to make their points without ad hominem attacks.

I make use of mod macros to reply to rude comments with a canned response that also links the sub rules. Mod macros save me time. These kinds of public mod comments do double duty because they communicate both to the specific user as well as the rest of the sub.

I'm not upset that users have different opinions, because difference of opinion provides fertile ground for discussion but I insist that users respect each other and do not try to provoke other users with inflammatory comments. I consider this style the reddit equivalent of the Broken Windows Theory.

Sometimes a user will reply, "Why are you punishing me, what about the other guy?". This is a practice known as "rules lawyering".

You cannot have any tolerance for rules lawyers. If you give in to a rules lawyer one time then it will never end. Enforce your rules consistently, calmly, fairly, and firmly. If you want users to use a good tone on the sub, then you have to use a good tone in your communication with them. Inform the user that you do not discuss mod actions that you take with other users. Each incident is it's own situation and you are under no obligation to explain to users what you've done to discipline other users.

If you ask a user nicely to knock it off and they respond rudely by telling you they will not follow the rules (possibly using profanity) then you'll have a decision to make about how you will reply. The decision will depend on context. Does this user have a track record or any usernotes?

If a user tells you they are not going to follow the rules then it may be time to move straight to step 4: Removal or restriction of posting privileges . Most users want a hands-off, invisible mod style and indeed really good moderation is often invisible to users. They want a mod to be fair and listen to reason but what happens when the user doesn't listen to reason?

There is not much use continuing a dialog with a user past this point. Think about it: You've calmly asked them to stop breaking the rules with no threat of enforcement -- just one user asking another nicely to stop. They reply that they will not stop.

You should be able to tell pretty quickly if a user is going to listen to reason and the situation could proceed to a ban rather quickly depending on how you react. You can only control your reaction and your comments. If this is taking place in 'public', keep in mind that the entire community will be watching and if you remain calm and fair while the user is going sideways you'll build credibility within the community.

It is also good policy to make sure that all mods on a team are on the same page regarding user discipline and banning procedures.

If you don't have policies in place for everything, don't worry. In the meantime, adopt a "check with me" policy for any actions for which policies haven't yet been developed. Many mods use discord, slack, or reddit chat to communicate. Mods that communicate regularly make for better and more consistent subreddit management. Who is the final decision maker when there's a difference of opinion? Make sure everything is clear so no one gets hurt feelings due to lack of communication.


Ok, so you've got a user that is starting to get unruly and he's not listening to you after you've asked him to cut it out. If he continues to escalate immediately or over the next several hours you may need to action him using mod tools.

Automoderator used independently or in conjunction with toolbox provides you several tools for mitigating problems. Take time to familiarize yourself with the various things these tools can do so that you'll have infrastructure in place to deal with these problems when they arise instead of scrambling for a solution after the problem is already in process.

There are several steps you can take between asking a user to stop and permanently banning a user.

  • Shadow banning a user silently removes everything they post on a sub without notifying them.

  • Temporary banning a user can be helpful to give a user a 'time-out'.

Shadow banning is a controversial practice some mods view as unethical but there are plenty of circumstances where it's the best answer. Is there a spammer posting their youtube channel without participating in the sub? Are you the only mod on a sub and you need to go to bed but a user is going off on a thread and you're worried it will provoke other users? Place the user on a shadowban and then revert it in the morning and review their comments for approval. Using toolbox, you can perform actions like these with 2 clicks without having to load other pages.

Best practices call for a sub to have a policy for what types of offenses merit a temporary ban. Temporary bans of 1-2 days can be very effective in making a user read and follow the rules, especially new users who may be on mobile where it's difficult for a user to even find the rules.

Temporary bans can be any length you choose. It is common for subs to use bans of 1-7 days or even 30 days. If you use a toolbox ban macro you'll be able to do this quickly and easily as well as provide links and information in hopes the user will read them and reform their behavior.


Once you've banned users it's also good policy to have an appeals process in place. If we do not provide second chances to users who've made a mistake, apologized, and promised to abide by the rules, then we remove the incentive for them to ever change their behavior. What your appeals process looks like is up to your sub, but for good faith users the focus should be on rehabilitation and reintegration with the community.

Sometimes a user will go the other way and they'll get very angry. Maybe they'll post on one of the various 'complaint' subs or even go so far as to create their own sub on the topic attempting to fork the community. If they post on a complaint sub don't go into the thread and defend yourself. You don't have to provide further justification or explanation in a public forum if you've operated in good faith. All communication with users should take place in modmail where it can be preserved and seen by the entire mod team.

If they create their own 'fork' sub, don't worry. I've had disgruntled users create their own sub on the same topic about a half dozen times. At first I tried hard to prevent it, but over time the subs created for this reason are rarely successful. Rule breaking, banned users will not be able to long manage a subreddit in which they will be required to write and enforce rules. It will be pretty clear to the user base that your sub is the better moderated one and the other sub shouldn't gain traction. Obviously exceptions to the rule do exist, but even if this new sub gains traction, if you are providing better content and better moderation your community should thrive and stand out.

In the case of failed 'fork' subs it's good for users to see how difficult it is to build and manage a community. If they continue to be inflammatory to you and your community they risk site-wide suspension.

In the case of a user starting to go sideways over a period of a few days or weeks I might reach out with a PM, especially if it's a long time sub member. If I can diffuse a situation with a couple of PMs it's worth the effort. If you've built up credibility in your sub then this process will be easier.

Users frequently need to be reminded that they hold all the power to make an argument stop by choosing not to reply or engage further. I will advise them to ignore or block a user who is bothering them (if the behavior doesn't rise to the level of requiring mod actions). Reddit's block feature is less than ideal but it does work in some situations. Ignoring a user and depriving them of attention is really the only reliable tool you can use and users need to be reminded of this.

This same approach also applies to modmail. Being calm, fair, consistent and reasonable throughout any communication in modmail should incentivize users to invest in the community and follow the rules. Any modmails, comments, and/or messages calling you a slur or using other abusive language should be reported to admins each time. When you provide admins with reports they are better able to establish a pattern of behavior providing greater context on a user's behavior. Recently there was an update to the harassment and bullying policy to address the issue.

While it remains to be seen how this policy will be enforced in practice and despite some growing pains (moderator suspensions), early returns on this policy have been positive. Accounts are being actioned quicker than in the past and I am confident that the kinks will be worked out regarding messaging and false positive moderator suspensions. Some interactions between users, such as abusive PMs, fall under the purview of admins and not mods and users should be referred to admins when appropriate.

In any event, a great majority of problems are caused by lack of communication so communicating clearly, consistently, calmly and fairly will provide you big dividends.

--

So, that is my policy on dealing with problem users.

There is no one-size-fits-all answer to how to deal with problem users and it is my hope that other experienced mods and sub members will chime in with their own mod philosophy, ideas, and style.


r/modguide • • Oct 29 '20

Mod news/updates You can now schedule Posts as AutoModerator with the new post scheduler

Thumbnail
reddit.com
26 Upvotes

r/modguide • • Mar 10 '20

Design Community sidebar (old/classic/legacy reddit)

26 Upvotes

The old reddit sidebar is edited via your community settings. This guide will show you how to edit it and make it look nice.

Reddit has two designs or interfaces. New users will probably only have experience of new reddit/redesign. Old/classic/legacy reddit is the old interface. Both new and old layouts exist together and it's important for mods to keep both up to date.

Using redesign mod tools

Using classic reddit for the first time

How to edit your sidebar

Go to mod tools at the bottom of your sidebar (in old), and select subreddit settings.

Image showing old reddit mod tools and the subreddit settings option

Fill out the sidebar box with your sidebar content.

Image showing the sidebar box in old reddit subreddit settings

Scroll down and hit save at the bottom of the page.

What should you put in your sidebar?

  • You can use it to add more community details in addition to the community description.

  • You should add your rules or a link to your rules

  • Links to Wiki pages

  • You can add a list of related subreddits

  • Useful links for your community

Formatting your sidebar

Old reddit sidebar formatting is done with Markdown:

  • Bold is done with a double asterix either side of your text **Bold**

  • For links use brackets like this: [link](http://reddit.com)

  • For lists use an asterix, plus, or minus, as your bullet points e.g. + List item

  • Hashes create headings: # heading 1 , ## Heading 2 , etc

  • For a horizontal line use three asterix, or three dashes: *** or ---

For further formatting help see: Reddit's commenting guide | Raerth's guide | Markdown primer

Styling your sidebar

As the old. reddit sidebar isn't made of customisable widgets, like the new/redesign one, you can use CSS to apply styling to your sidebar; You can find and use CSS snippets, write your own CSS, or use a pre-written theme to style your subreddit.

Some themes come with instructions for using markdown and CSS to style your sidebar, such as the theme used here on OrnithologyUK.

The theme used in this case is Minimaluminiumalism. You can find themes at r/themes.

Here are some CSS snippets we are using on modguide:

/*side bar text and background colour*/

.side .md { color: #000000; background: #ffffff none; font-size: 1em; line-height: 2.5; }

.side h1 {
    border-bottom: 1px solid #000000;
    text-align: center;
    font-size: 22px !important;
}

You can edit these snippets to suit your subreddit. For example by changing the colour: #000000 above to #389ce6 the text colour goes from black to blue.

You can find colour codes on sites like these: Colour-hex.com | w3schools colour picker | colorhexa

/* Sidebar buttons */
.side .md h3 a {
    display: block;
    border: 1px solid #0495ff;
    font-size: 12px;
    padding: 5px;
    border-radius: 3px;
    background-color: none;
    color: #0495ff;
    text-overflow: ellipsis;
    font-weight: bold;
    line-height: 25px;
    text-align: center;
    transition: background-color .5s;
}
.side .md h3 a:before {
    content: '';
    display: inline-block;
    background: url(%%bulb-1%%);
    background-repeat: no-repeat;
    width: 39px;
    height: 25px;
    background-size: contain;
    right: 258px;
    position: absolute;
}
.side .md h3 a:hover {
    text-decoration: none;
    color: #FFF;
    background-color: #0495ff;
}

And here (above) if you change border: 1px solid #0495ff; to #000000 the blue border of our button links goes from blue to black.

This bit background: url(%%bulb-1%%); refers to the light bulb image used in our buttons - images need to be uploaded to the stylesheet. See the Intro to CSS guide.

/* Filter buttons (from r/community_chat and r/SubChats) */
.side a[href="#button"] + a {
    position: static;
    width: 290px!important;
    border: 1px solid #0495ff;
    z-index: 50;
    margin-left: 2px;
    background-color: none;
    color: #0495ff;
    padding: 2px;
    display: block;
    border-radius: 4px;
    text-align: center;
    font-size: 14px;
    overflow: hidden;
    transition: all .5s ease;
    text-decoration: none!important;
}

This bit (below) changes the button appearance on hover (when your pointer is over it).

.side a[href="#button"] + a:hover {
    background-color: #0495ff;
    color: #FFF;
}

Image of the finished sidebar and the markdown formatted text that was further styled with these snippets.

See r/csshelp and their sidebar for further help with CSS.

Where does the old sidebar display?

Related guides

---

Thanks u/MajorParadox who formatted and styled our sidebar.

Do you know of any other themes with good instructions for cusomising subreddit sidebars?


r/modguide • • Jan 24 '20

Bots Custom Moderation Bots

26 Upvotes

Sometimes you want to add some features or functions to your subreddit that either AutoModerator (see our article here) or or general moderation bots (see our article here) can't do. Maybe you need a bot with a very particular set of skills. If that's the case, maybe you need to look into getting a custom bot for your subreddit.

Author disclaimer: I am the writer and maintainer of u/AssistantBOT, and a mod on r/Bot, which is a subreddit for sharing moderator bots. I've also written many custom subreddit bots for my own and others' subreddits.

What is a custom subreddit bot?

A custom subreddit bot is a bot that is written for and operates only on one (or a couple) subreddits. The bot does the functions the moderators of that subreddit have specifically asked it to do, and no other. Such bots are usually given a specific moderator account on the subreddit and run or hosted by the moderators of the subreddit instead of by Reddit or other users.

What are some of the common use cases for custom bots?

Here are some of the most common use cases for custom bots with examples for each:

And many more!

What can bots do that AutoModerator can't?

AutoModerator is of course super useful but it has several limitations:

  1. It only acts upon posts at the time of submission or editing. It cannot, say, automatically check posts several hours or days after their submission.

  2. AutoModerator has no concept of a database for tasks such as points tabulation. You can try to hack something with user flairs or post flairs but it's rather inelegant and prone to error.

  3. AutoModerator cannot connect to outside data sources to access or retrieve data other than the things which are already encoded into media placeholders.

What are the advantages / disadvantages of having custom bots?

Advantages include being able to do basically anything that you want to do with a script! Different subreddits have come up with a ton of creative ways to use bots in ways that augment and expand their community, as the above examples show. If you have a good idea and your subscribers like it, there's no reason to not have a bot.

Disadvantages primarily relate to the technical side of things.

  • Bots need to be hosted somewhere, whether it's on the cloud, on a server you or someone else owns, or even your own computer. If it's a bot that needs to be available all the time, then the script itself has to be run continuously. This can be expensive if it's hosted on the cloud or annoying if you have to host it on your own PC.

  • Someone needs to write and set up the code to work properly. Even if the code is open source and can be obtained from GitHub, it will need to be adapted to work with the specific bot account you want it to run on and for the local environment in which it will be deployed.

Where can I find / get code for custom bots? Or learn how to write one?

First of all, r/RequestABot is the primarily place for Reddit bot requests. People can help you write a bot there, but please be sure to include as much information as possible in your request and not make a vague or low-effort request. It's best if you already have a concrete idea for what you want to do with your bot. You can also look through GitHub to see if there are already existing bots that fit what you need (be sure to check that they're open source though!). r/RequestABot also has a guide to running Python code someone gives you.

Secondly, if you know how to write code, you can perhaps try writing it yourself. The most used language for writing Reddit bots is Python, specifically using PRAW wrapper to access the Reddit API. Reddit wrappers are modules that help adapt the Reddit API in syntax and style that is appropriate for a programming language (see here for more on wrappers). Check out the PRAW Quick Start guide to begin familiarizing yourself with how it works.

For languages other than Python, JRAW is a wrapper for Java, Snoowrap is an API wrapper for JavaScript, RedditSharp is one for [C#](https://en.wikipedia.org/wiki/C_Sharp_(programming_language)), GRAW for Go, and Phapper is for PHP. For even more languages see this list on the official archived Reddit repo.

Reddit has a host of subreddits where you can learn how to code, for example, r/learnpython for Python learners, so don't be afraid to ask the community if you have questions.

Where can I host custom bots?

This is the tricky part. Bots are just scripts running on a user account. If a bot needs to be constantly available, the script must also be constantly running. u/Mustermind has outlined 3 options, and I've noted a couple more, in no particular order:

  1. Heroku (see u/PostitivePlayer1's guide here)

  2. Azure/EC2 Free Tier, virtual machines (Azure guide, EC2 guide)

    • These usually only give you a free year of service; after that you need to either pay or figure something else out.

  3. A Raspberry Pi. They're cheap ($35 for the cheapest Pi 4) and available on Amazon, Adafruit, and other online outlets.

  4. Your own PC/Mac. Provided that you keep it on all the time anyway. (Note that the Pi will be a lot more energy efficient than your own computer)

  5. PythonAnywhere. Their free tier allows for a good amount of experimentation, but you may run into issues if your bot is particularly active.

  6. DigitalOcean. Use a droplet (a virtual machine).

  7. RamNode. Link.

  8. ChunkHost. Link.

What is Bottiquette?

If deploying a bot that posts or comments on areas outside of your own subreddits, please keep in mind Bottiquette. Don't make bots that spam or are a nuisance to others.


Thoughts? Comments? Let me know below!


r/modguide • • Dec 22 '19

Design How to add a subreddit icon & edit the display of your sub name in redesign

26 Upvotes

How to add an icon to a subreddit is a common question, here is how to do it.

You need to be on desktop to be able to upload an icon to your subreddit (at time of writing) - what you can do on mobile in app is very limited. You could try desktop mode in your mobile browser, but desktop is better. [This can now be done in app - see our mobile guides, this guide is for desktop/new reddit]

EDIT- There's a quirk in new reddit since they made some changes earlier this year. The display looks different when normally viewing the whole sub, to when you have a post open and refresh - basically you can see the old layout where sub name and icon appear on top of the banner. See the above mod tools guide for the fix.

---

You can change the large text community name/display name in your community settings -

Mod tools (top of sidebar on the right), community settings (sidebar on the left)

Use the the 'community name' box at the top of the community page.

Further styling options that were available, like hiding the icon, don't seem to be functional at the moment/since the change to redesign work but you can't preview the changes and they are only viewable on the refreshed post page as mentioned above.

Last update 17th Jan 2020

---

This guide was updated after changes to redesign.

There are planned changes to redesign in Jan 2020 which will change where your icon shows

---


r/modguide • • Sep 24 '19

Mod Boot Camps Mod Boot Camp - STARTING SOON

26 Upvotes

Welcome to Mod Boot Camp

These are sessions to help new mods or people who want to be mods learn the absolute basics of moderating in a small group setting with experienced moderators.

We will cover modding mainly from a desktop perspective but also from the Reddit app. These sessions are run between discord and reddit

Please see the comments for currently available sessions. If a sub would like to arrange training of a group of their mods or potential mods please feel free to contact solariahues or myself to set this up.

Topics Covered

Approving posts

Removing posts

Looking at reports

Removing comments

Greenhatting / Distinguishing

Modmails

Warnings

Muting (aka Shadowbanning)

Bans

Stickying post

Stickying comment

Locking comments

Changing the flair

Mod Queues

Chatroom modding

Modding on app

The sessions will end with a Q&A section and the topics covered may be added to at a later date based on feedback. (If you have any you think we have missed please drop me a PM)

To enable the bootcamp we have a private sub that people will be added to as mods to not only learn about these skills but to also try them out in a safe and monitored way. We have lots of trouble makers in there who need some moderation!

Upon completion of Boot Camp users who have successfully shown understanding and application of the topics will receive the ModCamp Graduate Flair on r/ModGuide.

Edit: to sign up pop a comment down below with your preferred session and I will be in touch shortly to confirm!