# Moderation Setup

> **Click** [**here**](https://discord.com/oauth2/authorize?client_id=1069423090225918082\&permissions=275146722545\&integration_type=0\&scope=applications.commands+bot\&redirect_uri=https%3A%2F%2Fcommunityone.io%2Fdashboard%2Fbot-auth-complete%2F%3Fsource%3Dgitbook\&response_type=code) **to introduce our bot to your server.**

Here's a quick overview of setting up your custom moderation rules from the dashboard: To get started, go to your dashboard, navigate to the **Moderation** tab, and toggle the Master Switch to enable moderation. *(Note: Moderation is a premium feature).*

<figure><img src="/files/Mw6qFywDyQ3AZqKo7m6K" alt=""><figcaption></figcaption></figure>

#### Global Settings Configuration

Before setting up individual rules, you can configure global settings that apply across your server:

* **Quarantine role:** Select a specific role to assign to users when they trigger a 'Quarantine' sanction. This must be set if you plan to use the Quarantine action.
* **Whitelisted roles:** Select roles (such as your Admins or Moderators) that should bypass moderation entirely. Members with any of these roles are never moderated.

<figure><img src="/files/FrVcNNuBwNHJL6EbJlSn" alt=""><figcaption></figcaption></figure>

#### 4 Types of Moderation Categories

<figure><img src="/files/yqLZbsfB8nl3DcACXrJW" alt=""><figcaption></figcaption></figure>

You can customize distinct rules across four main categories:

1. **Member History:** Flags new members who are already banned in other servers using CommunityOne (checked automatically on join).
2. **Spam / Scam Behavior:** Detects mass mentions (pinging `@everyone` or `@here`), same message spam, posting resumes, asking for DMs, and money/crypto schemes (e.g., CashApp/Venmo offers, fake jobs, "passive income" pitches).

<figure><img src="/files/WmTfdrfT2vWhyUF82R9o" alt=""><figcaption></figcaption></figure>

1. **Links:** Flags any clickable link or Discord invite links. For the "Any clickable link" rule, you can set up **Exception domains** (e.g., `youtube.com`)—links to these domains (and their subdomains) will automatically bypass the rule.

<figure><img src="/files/9pQhiRMReKQJRJYeAlYi" alt=""><figcaption></figcaption></figure>

1. **NSFW:** Detects and flags NSFW links, sexual chat, and sexual images.

<figure><img src="/files/gvVhmqMqtRjBgFaF3M6t" alt=""><figcaption></figcaption></figure>

#### Advanced Rule Setup

For every individual rule, you can configure exactly how aggressive the moderation should be:

* **Enable:** Turn the rule on or off. When enabled, moderators will receive an alert in your designated notification channel every time the rule is triggered.
* **Delete rule-breaking message:** Automatically remove the offending message instantly, without deleting the user's entire message history.
* **Sanction:** Determine what action to take against the user in addition to the notification and deletion. Options include:
  * **None**
  * **Timeout**
  * **Quarantine** *(Requires a Quarantine role in Global Settings)*
  * **Kick**
  * **Ban** *Once you have configured your categories and rules, remember to click **Save Changes** at the bottom of the page to apply your new moderation policy!*

<figure><img src="/files/O8ldRq5NqpODFpfewdxC" alt=""><figcaption></figcaption></figure>

#### How Moderation Works Behind the Scenes

Our moderation system is designed to be highly accurate while minimizing false positives. Here is the step-by-step process of how it behaves in your server:

1. Continuous Monitoring: The bot automatically listens to all messages sent in your server.
2. Smart Triggering: When a message hits specific triggers or suspicious keywords, it gets flagged for review.
3. Real-time AI Verification: Instead of blindly deleting messages based on keywords alone, we run flagged messages through our AI models to understand context and intent. This double-check ensures that normal conversations aren't accidentally punished.
4. Action & Logging: If the AI confirms the message violates your policy, the bot executes the exact sanctions you configured in your dashboard (e.g., notifying you, deleting the message, or timing out the user). Regardless of whether you delete the message, every flagged action is fully recorded and can be reviewed in your server logs.

<figure><img src="/files/ZbGLHu4TcShlxXu0FXPy" alt=""><figcaption></figcaption></figure>

#### Member Lookup & Cross-Server Intelligence

Understanding a member's history is crucial for keeping your community safe. We make it easy to pull up a comprehensive background check directly within Discord.

<figure><img src="/files/PEZ0jOsj9dBgaoeFYXs9" alt=""><figcaption></figcaption></figure>

To investigate a member: Right-click on the user ➔ Apps ➔ Moderation Lookup

This command provides an instant report containing:

* Local Server History: Automatically view a log of all past offenses and moderation actions taken against this user within your own server.
* Global Server Intelligence: See if this user has had actions taken against them in other communities using CommunityOne. We will tell you exactly how many times they've been banned and the general category of those servers.

<figure><img src="/files/jm51LktisTLdGUI2PYvk" alt=""><figcaption></figcaption></figure>

Why is this useful? Most moderators won't ban a user *just* because they were banned on another server. However, if you run a Web3 project and see a new member who has been banned 10 times across different crypto servers, that's a massive red flag that warrants your immediate attention.

#### Member Reporting (`/report`)

Community moderation is a team effort, and your members are often the first line of defense.

If a user wants to officially complain about another member's behavior, they can use the `/report` command.

<figure><img src="/files/QczK05D3PUt7wObg5nsI" alt=""><figcaption></figcaption></figure>

When a report is submitted:

* The complaint is securely logged.
* When your team runs a Moderation Lookup on the accused user, the report history will be surfaced immediately. You will be able to see exactly who reported this user in the past and why, helping you identify problematic members who might be causing trouble in DMs or quiet channels.

<figure><img src="/files/0bDnLS2Epzdasn0XUMgh" alt=""><figcaption></figcaption></figure>

<br>

{% hint style="info" %}
Join [Discord](https://discord.gg/nVqt3z78Mw) for questions, comments, and a little gift <img src="https://fonts.gstatic.com/s/e/notoemoji/latest/1f381/512.gif" alt="🎁" data-size="line"> or back to [CommunityOne Home](https://communityone.io/)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://communityone.gitbook.io/communityone/feature-deepdive/moderation-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.