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

# Moderation

> Act on members of your Discord server, with a case recorded behind every decision.

Moderation in Cove is built around cases. Every action leaves one — who did it,
to whom, why, and when — so "why is this person banned" still has an answer six
months later.

<Frame caption="Every case in the workspace, numbered.">
  <img src="https://cdn.coveapp.cc/docs/images/moderation/cases.png" alt="Moderation → Cases" />
</Frame>

## Actions

| Action  | What happens                           |
| ------- | -------------------------------------- |
| Note    | Recorded only; nothing happens to them |
| Warning | Recorded, and the member is told       |
| Timeout | 1 hour, 6 hours, 1 day or 1 week       |
| Kick    | Out of the server; they can return     |
| Ban     | Out, and kept out                      |
| Unban   | Lets somebody back in                  |

Every case takes a reason, up to 400 characters. It is the part somebody reads
later, so it is worth writing properly.

## Where a case came from

The **Cases** page lists every case in the workspace, numbered per workspace —
case 14 is the fourteenth here, not the fourteenth across Cove.

| Source           | Meaning                                          |
| ---------------- | ------------------------------------------------ |
| Moderator        | A person did it                                  |
| Auto-moderation  | Cove acted on a rule                             |
| Staff protection | The [staff watch](/moderation/staff-watch) acted |

## Reverting

A case can be reverted — a ban lifted, a timeout cleared — and it keeps its
history rather than disappearing.

Reverting is its own permission, separate from moderating, on purpose: the
point of a revert is that somebody *other* than the person who acted can
correct a mistake, and that doesn't work if only moderators can do it.

<Warning>
  Cove can only act on members Discord lets it act on. It cannot moderate the
  server owner, or anybody whose highest role sits above the bot's own — move
  the Cove role up if you want it to cover your team.
</Warning>

## Permissions

| Permission                 | What it allows                            |
| -------------------------- | ----------------------------------------- |
| Moderate members           | Open cases and read the history           |
| Revert cases               | Undo a case, including somebody else's    |
| Change moderation settings | The switches, log channel and staff watch |
