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

# Moderation

> A clear reference for member, channel, and role moderation with Hedwig.

Hedwig covers the day-to-day work of a Discord moderation team: member actions,
warnings, channel controls, role management, server lists, and message cleanup.
Every action is still subject to the invoking member's Discord permission and
the bot's role position.

## Member actions

| Command      | What it does                   |
| ------------ | ------------------------------ |
| `/kick`      | Kick a member                  |
| `/ban`       | Ban a member                   |
| `/unban`     | Remove a ban                   |
| `/tempban`   | Ban a member temporarily       |
| `/softban`   | Ban and remove recent messages |
| `/mute`      | Mute a member                  |
| `/unmute`    | Remove a mute                  |
| `/warn`      | Add a warning                  |
| `/warnings`  | View a member's warnings       |
| `/clearwarn` | Remove a member's warnings     |
| `/nick`      | Change a member's nickname     |

<Note>
  Moderation commands are still limited by Discord permissions and role
  hierarchy. Hedwig cannot moderate a member whose highest role is equal to or
  above the bot's highest role. Owner-level Discord members and protected
  roles may also be unavailable as targets.
</Note>

## Channel controls

| Command           | What it does                            |
| ----------------- | --------------------------------------- |
| `/lock`           | Lock a channel                          |
| `/unlock`         | Unlock a channel                        |
| `/hide`           | Hide a channel                          |
| `/unhide`         | Unhide a channel                        |
| `/slowmode`       | Set channel slowmode                    |
| `/channel create` | Create a channel                        |
| `/channel rename` | Rename a channel                        |
| `/channel move`   | Move a channel to a category            |
| `/channel topic`  | Edit a channel topic                    |
| `/delete channel` | Delete a channel                        |
| `/cleanup`        | Delete Hedwig's messages from a channel |
| `/purge`          | Delete channel messages                 |

These are message-command aliases, not slash-command aliases: `,cc` for
`channel create`, `,cr` for `channel rename`, `,cm` for `channel move`, `,ct`
for `channel topic`, `,channeldelete` for `delete channel`, `,deleterole` for
`delete role`, `,deleteemoji` for `delete emoji`, and `,whohas` for `list
inrole`. Use the configured server prefix instead of `,` when it differs.

## Roles and server lists

| Command            | What it does                |
| ------------------ | --------------------------- |
| `/role add`        | Add a role to a member      |
| `/role remove`     | Remove a role from a member |
| `/ar`              | Add a role to a member      |
| `/rr`              | Remove a role from a member |
| `/roleicon`        | Set a role icon             |
| `/autorole add`    | Add an autorole             |
| `/autorole remove` | Remove an autorole          |
| `/autorole show`   | Show configured autoroles   |
| `/rolecreate`      | Create a role               |
| `/roledelete`      | Delete a role               |
| `/delete role`     | Delete a role               |
| `/delete emoji`    | Delete a custom emoji       |
| `,list boosters`   | List server boosters        |
| `,list bots`       | List server bots            |
| `,list roles`      | List server roles           |
| `,list inrole`     | List members in a role      |

These list commands are message/prefix commands. `,whohas` is an alias for
`,list inrole`.

### Autoroles

Autoroles are assigned when a member joins. Use `/autorole add` with a role,
`/autorole show` to review the current list, and `/autorole remove` to delete
an entry. The invoking user needs **Manage Server**. When the bot assigns a
role, it also needs **Manage Roles**, and its highest role must be above every
autorole. Autoroles do not retroactively change existing members.

## Evidence and message recovery

| Command      | What it does                   |
| ------------ | ------------------------------ |
| `/snipe`     | View recently deleted messages |
| `/editsnipe` | View recently edited messages  |
| `,ghostping` | Check recent ghost pings       |

`list` and `ghostping` are message/prefix commands.

## A safe moderation workflow

<Steps>
  <Step title="Log the action">
    Keep event logging enabled so staff can review what happened.
  </Step>

  <Step title="Use the least destructive action">
    Start with a warning or mute when a ban is not necessary.
  </Step>

  <Step title="Check the target">
    Use `/userinfo` and `/permissions` before changing roles or taking action.
  </Step>

  <Step title="Document exceptions">
    Keep allowlists and staff permissions intentional. Use `/antinuke status` when an incident involves destructive actions.
  </Step>
</Steps>

## Before troubleshooting a failed action

Use `/userinfo` to confirm the target and `/permissions` to inspect the
invoking member. Then check the bot's role position, channel overrides, and
whether the channel is ignored with `,ignore` (or the server's configured
prefix). `/purge`, deletion commands, bans, and role changes are destructive;
use them only in channels where the moderation policy is clear.