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

# Moderation Overview

> What Heimdall's moderation suite covers and how the different components work together.

Heimdall's moderation plugin combines manual enforcement commands, an automated rule engine, progressive escalation, and a full infraction history. All of these components share the same underlying infraction system, which means manual warnings and automatic rule violations accumulate in the same point total and feed into the same escalation thresholds.

![Moderation Dashboard](https://mintcdn.com/bifrost-77/eYh0raruv0sMd-gD/images/Moderation_Dashboard.png?fit=max\&auto=format\&n=eYh0raruv0sMd-gD\&q=85\&s=0e702bbfe9f307beceeb77b21a6fa8b3)

## Components

> [card] [Manual actions](https://heimdall.gg/docs/moderation/manual-actions.md)
>
> Issue warnings, bans, kicks, mutes, and message purges directly.

> [card] [Automod rules](https://heimdall.gg/docs/moderation/automod.md)
>
> Define keyword filters, regex patterns, and content-type rules that enforce automatically.

> [card] [Escalation](https://heimdall.gg/docs/moderation/escalation.md)
>
> Configure automatic punishments that trigger as a member accumulates infraction points.

> [card] [Infraction history](https://heimdall.gg/docs/moderation/infractions.md)
>
> View every action taken against a member, including point totals and expiry dates.

> [card] [Channel controls](https://heimdall.gg/docs/moderation/channel-controls.md)
>
> Lock channels, apply per-channel bans, and prevent members from leaving and rejoining to evade bans.

> [card] [Sticky messages](https://heimdall.gg/docs/moderation/stickies.md)
>
> Keep a message pinned to the bottom of a channel automatically.

> [card] [Appeals](https://heimdall.gg/docs/moderation/appeals.md)
>
> Let banned members request a review through a structured form.

## How infractions and points work

Every moderation action - whether taken by a staff member or by automod - creates an infraction record. Each record stores the action type, the reason, the staff member or rule that triggered it, a configurable point value, and an optional expiry.

Points accumulate over time. When a member's total active points cross a threshold you configure in the escalation settings, the bot automatically applies the corresponding punishment. Points expire individually based on each infraction's expiry period, and as they expire, the member's total decreases.

This means a member who receives multiple minor warnings over a week may trigger an automatic mute, even if no single action crossed a threshold on its own.

## Dashboard location

Navigate to [**Moderation**](https://bot.bifrost.gg/go/moderation) in the dashboard sidebar. The moderation section has these pages: [**Overview**](https://bot.bifrost.gg/go/moderation/overview), [**Rules**](https://bot.bifrost.gg/go/moderation/rules), [**Escalation**](https://bot.bifrost.gg/go/moderation/escalation), [**Stickies**](https://bot.bifrost.gg/go/moderation/stickies), [**Auto-Responses**](https://bot.bifrost.gg/go/moderation/auto-responses), [**Leave Bans**](https://bot.bifrost.gg/go/moderation/leave-bans), [**Channel Bans**](https://bot.bifrost.gg/go/moderation/channel-bans), [**Locked Channels**](https://bot.bifrost.gg/go/moderation/locked-channels), [**Slow Mode**](https://bot.bifrost.gg/go/moderation/slow-mode), and [**Settings**](https://bot.bifrost.gg/go/moderation/settings).

Infractions are now [cases](https://heimdall.gg/docs/moderation/cases.md), under [**Cases**](https://bot.bifrost.gg/go/cases/list), and ban appeals have their own [**Appeals**](https://bot.bifrost.gg/go/appeals) section.

## Required permissions

Dashboard access and command usage are both controlled by the Heimdall permission system. Key permission keys for moderation:

| Key | What it controls |
| - | - |
| `moderation.enforcement.warn` | Running `/warn` |
| `moderation.enforcement.ban` | Running `/ban` and `/unban` |
| `moderation.enforcement.kick` | Running `/kick` |
| `moderation.enforcement.mute` | Running `/mute` |
| `moderation.enforcement.purge` | Running `/purge` |
| `moderation.enforcement.lock_channels` | Running `/lock` and `/unlock` |
| `moderation.enforcement.manage_rules` | Creating and editing automod rules in the dashboard |
| `moderation.config.view_config` | Viewing moderation configuration in the dashboard |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.