> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrumpbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Moderation

> Ban, kick, and timeout members with consistent logs and a permanent moderation archive

Scrump provides moderation commands for staff actions and records supported actions performed through Discord's interface or other bots.

## Moderation commands

| Command                                     | Purpose                                            | Moderator permission |
| ------------------------------------------- | -------------------------------------------------- | -------------------- |
| `/ban target: reason: delete_message_days:` | Ban a member and optionally remove recent messages | Ban Members          |
| `/unban target: reason:`                    | Remove a server ban                                | Ban Members          |
| `/kick target: reason:`                     | Remove a member from the server                    | Kick Members         |
| `/timeout target: duration: reason:`        | Temporarily prevent a member from interacting      | Timeout Members      |
| `/untimeout target: reason:`                | Remove a member's timeout                          | Timeout Members      |

Scrump also checks role hierarchy and its own Discord permissions before applying an action.

## Configure the moderation log

<Steps>
  <Step title="Open Security">
    Open your server at [scrumpbot.com](https://scrumpbot.com), then select **Security**.
  </Step>

  <Step title="Choose a log channel">
    Under **Moderation logging**, select the private text channel where Scrump should post action summaries.
  </Step>

  <Step title="Review permissions">
    Resolve any missing-permission warning shown at the top of the page. Audit synchronization requires **View Audit Log**.
  </Step>
</Steps>

Every Scrump moderation command creates one log-channel message and one archive entry. Scrump correlates the Discord audit entry with the command so the same action is not recorded twice.

Actions performed through Discord's interface and supported actions from other bots are also archived. Their source is labeled so they can be filtered separately.

## Moderation archive

Free servers can use the Discord log channel. Plus adds the searchable website archive and moderation analytics.

The archive can be searched by target, moderator, action, source, date, and reason. Archive rows cannot be deleted by server users. A server manager can redact reason text; the redaction is itself recorded.

| Plan | Website archive window |
| ---- | ---------------------- |
| Free | Not included           |
| Plus | 30 days                |
| Pro  | 2 years                |

## Custom target messages

Plus and Pro can customize the DM sent to a moderation target. Messages can be plain text or a Discord embed and support these variables:

`{user}`, `{server}`, `{action}`, `{reason}`, `{duration}`, `{expires}`, and `{moderator}`

The dashboard includes a live Discord preview. Invalid configurations fall back to Scrump's default message. If the target cannot receive DMs, the moderation action still succeeds and the archive records the failed DM.