All documentation

Auto-moderation

Auto-moderation examines each published message and compares it against a list of forbidden words or phrases defined by the server. On a match, the author receives an automatic warning and the moderation team is notified.

The list belongs to the server: there is no global list imposed on anyone. A gaming server and a professional one do not draw the line in the same place, and each defines its own.

Last updated:

How a match is established

A single-word entry is compared against the message's words taken individually: the term must appear as a whole word, so an innocuous word containing the forbidden sequence does not trigger an alert.

A multi-word entry is searched as a phrase across the whole message, which allows targeting a specific turn of phrase rather than an isolated term.

What happens on a match

  • A warning is recorded automatically against the author, with the matched term or terms as its reason.
  • A notification is posted in the server's configured moderation channel.
  • The warning joins the member's history, readable with *getwarn.

Configuration

The module is enabled in the dashboard, Auto-moderation section, where the list of terms and the destination channel for alerts are set. It is disabled by default: no message is examined until an administrator enables it.

Message content is never kept. Only the forbidden term that triggered the alert — which comes from the server's own list — is stored as the reason of the warning.

Frequently asked questions

How do I filter profanity automatically on Discord?

Enable the Auto-moderation module in the dashboard, enter the list of terms to filter and choose the channel that will receive alerts. Each matching message triggers an automatic warning and a notification to moderators.

Does the bot store the messages it examines?

No. The message is compared against the list in memory and then discarded. Only the forbidden term that triggered the alert is kept as the warning's reason.

Can the word list differ per server?

Yes, and that is the default: each server defines its own list. There is no global list applied across servers.