About the Moderation Plugin

It's our goal to be the leading and soul defender of your server from all wrongdoers, that's why we're constantly developing our moderation features to stay on top of the currents. Circle's moderation plugin enables all 20+ of her moderation commands, all highly customizable, along with enabling automatic punishments in the automod plugin.

Getting Started

1. Navigate to your server's dashboard.
2. Select the Moderation plugin. If it's not enabled, you'll need to enable it.
3. Select a "Modlog Channel" from the drop-down. This plugin will not work without a modlog channel set!
4. Follow the instructions below.

Configuring Mutes

Circle supports two ways of handling mutes:

1. Recommended: Mutes will be applied via Discord's time out feature (learn more). This makes setup way easier! Just tick the "Use Discord's timeout feature to mute members" box and you're all done (this is enabled by default on servers that added Circle after Dec 20th, 2021).
2. Mute members by applying a role. You can learn more here.

Setting Timed Moderations

Some moderation commands allow you to set a time for when the moderation should expire. Circle accepts many different forms of times for you to use, and Circle's time parser will do its best to figure out the exact time that you want to moderate the user for. For more precise times, you can use spaces or commas to separate different time units. For example, you could do something like c!mute @user 1 hour, 15 minutes to mute someone for an hour and 15 minutes.

For more information about what units of time Circle accepts, as well as examples on how to set time limits on moderations, click here.

Each moderation action type has a time limit for how short or long you can set it to. The minimum and maximum limits are as follows:

Purging Messages on Ban

Circle will optionally delete up to a week of messages from a member when they're banned. This is known as "Ban Delete Days".

1. Select a number between 0-7 days from the "Ban Delete Days" drop-down.
2. Scroll down and press "Save".

Assigning Moderator Permissions

Your moderators must have the selected roles to receive the server moderator permission. Users with one of these roles immediately have access to all of Circle's moderation commands in your server.

1. Select your moderator roles in the "Moderator Roles" drop-down.
2. Scroll down and press "Save".

Setting Up the Muted Role

This role will be assigned to members when they get c!mute 'd. It should revoke member's permissions to speak in your channels.

1. Pick your muted role from the "Muted Role" drop-down.
2. Scroll down and press "Save".

Muted Role Permissions

For users to actually be silenced, you'll need to make sure your muted role permissions actually restrict them from talking. This can be confusing, so follow this guide and we'll do it together.

Configuring Permissions for Public Channels

1. Open a channel's/category's settings.
2. Click the permissions tab.
3. For every role, set the Send Messages permission to /.
4. Set your muted role's Send Messages permission to X.
5. Repeat this for every channel you don't want muted people to talk in.

Configuring Permissions for Secret Channels

1. Open a channel's/category's settings.
2. Click the permissions tab.
3. Make sure the @everyone role cannot read messages by setting the View Channel permission to X.
4. For every role, set the Send Messages permission to /.
5. Give the special role(s) (a "Staff" role, for example) permissions to view the channel by setting the View Channel permission to ✓, leave the Send Messages permission on /.
6. Set the muted role's Send Messages permission to X.

Still need Help?

It's no worries! Our support team is ready to help.

Configuration Options

• Show voided cases on the c!modlogs command - If enabled, Circle will show all modlogs for a user, even if they're voided.
• Show case number on mod command confirmation - If enabled, Circle will prepend the case number to the confirmation message.
• Show reason on mod command confirmation - If enabled, Circle will append the reason to the confirmation message.
• Require reasons on moderation actions - If enabled, Circle will require all moderators to provide a reason for their moderation action.
• DM users when they are moderated - If enabled, Circle will attempt to DM a member when they get kicked/softbanned/muted/banned. Circle will always messages members when they're c!warn'd.
• Show moderator username in moderation DM - If enabled, Circle will show the username of the moderator who moderated the user in their moderation DM. "DM users when they are moderated" must be enabled for this option to work.
• Delete mod command invocation message - If enabled, Circle will delete the moderation command from chat after it's ran.
• Use Discord's timeout feature to mute members - If enabled, Circle will use the time out feature instead of using traditional role-based mutes.
• Require a duration on all mutes - If enabled, Circle won't allow moderators to administer permanent mutes.
• Remove roles from members when they are muted - If enabled, Circle will remove every role from a member when they get muted, then give them back when they get unmuted. Circle will still assign and unassign the muted role.

Preset Reasons

What are Preset Reasons?

Preset Reasons are a way for you to make moderation faster by using condensing common reasons into a simple, easy to remember shortcut. For example, let's say you have a rule in your server that members must have their nickname set to bread, people usually overlook that rule which results in moderators warning a lot of people with some variation of "Rule 1 - Your nickname MUST be set to bread."

Typing all that takes time, but with preset reasons we can do something like this:

Now, we can warn members like so: c!warn @aaron#5115 r1, which would result in a warning for, Rule #1 - Your server nickname MUST be set to bread. Neat!

Creating a Preset Reason

1. Click the "CREATE NEW" button in the "Preset Reasons" box.
2. Enter the shortcut, this'll be what your moderators type in the command reason. (This cannot have any spaces, and must be less than 16 characters!)
3. Enter the reason you want to correspond the shortcut to.
4. Once you're happy, press "CREATE" to create your new preset reason.
5. The new reason will then appear in your list of preset reasons. You can then press "EDIT" to make changes to it, or press "DELETE" to delete it.

Updated on: 09/11/2025