> For the complete documentation index, see [llms.txt](https://docs.asagi.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.asagi.xyz/guides/configuring-bot-features/moderation.md).

# Moderation

## Automatic Moderation Settings

### General

{% hint style="info" %}
Each filter has its own settings.
{% endhint %}

### Punishments for Violations

You have three types of punishments to choose from: **Timeout**, **Kick**, **Ban**.

<figure><img src="/files/416rNU93bjRbcJtF9eAM" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can only set a duration for the "Timeout" type of punishment.
{% endhint %}

{% hint style="warning" %}
Time Format: \
d - days \
h - hours \
m - minutes \
s - seconds

Example: 21d15h9m20s \
The punishment will be applied for 21 days, 15 hours, 9 minutes, 20 seconds.
{% endhint %}

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

#### Result:

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

### Ignoring Channels

Imagine you have a dedicated text channel for sending links, and you don't want to apply any sanctions to users in that channel.

<figure><img src="/files/5csmt5AfsyHAXAzXflYM" alt=""><figcaption></figcaption></figure>

### Ignoring Roles

Imagine you have members with certain roles who should be allowed to send links, and you don't want to apply any sanctions to them.

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

### Notify Member about Violation

Members may not understand what happened, so we recommend notifying them about violations they may not be aware of.

{% hint style="info" %}
There are two notification options:&#x20;

* The channel where the violation occurred.
* Direct messages.
  {% endhint %}

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

{% hint style="info" %}
There is no default violation message, so you need to specify the text yourself.&#x20;

Both plain text and [JSON ](/guides/json-builder-in-the-asagi-bot.md)code are supported.&#x20;

[Variables](/other/message-templates/variables.md) are also available.
{% endhint %}

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

## Automatic Moderation Filters

### Links

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any link is found.

#### How does it work?

This filter reacts to messages containing any links.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

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

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Links</mark>".

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

### Invitations

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any Discord invitation found.

#### How does it work?

This filter reacts to messages containing any Discord invitation.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

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

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Invitations</mark>".

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