Moderation App

Automatically filter harmful content, catch spam, and keep your community safe.

note

Installing and managing Apps and Bots requires Root on desktop. Once installed into a community, Apps and Bots can be used on Root desktop and mobile.

What is Moderation?

Moderation is a community app that helps community owners maintain a healthy environment by automatically removing harmful messages and detecting spam. The app scans messages against built-in slur and profanity lists, custom word filters, and spam detection rules. When a rule is triggered the message is deleted automatically. Disciplinary actions like kicks and bans remain in the hands of human moderators. A full audit log and analytics dashboard give admins visibility into moderation activity.

How it works

When a member sends a message in a monitored channel, the app evaluates it against two rules in order: content filter, then spam detection. The first rule that triggers stops evaluation and the message is deleted. Edited messages are re-checked by the content filter. Every deletion is recorded in the audit log.

Content filter

The content filter checks messages against word lists. Three categories of words can be filtered independently:

Category	Description
Slurs	A built-in list of slur terms. Enabled by default.
Profanity	A built-in list of profanity terms. Enabled by default.
Custom words	Words added by admins for the community. Enabled by default.

The filter normalizes text (lowercasing, common letter substitutions) before checking, so variations like "l33t" still match. Admins can also maintain an allowed words list. Words on this list are never filtered, even if they match a rule.

Optionally, the app can send a public warning message in the channel when content is filtered.

Spam detection

Spam detection identifies repeated identical messages from the same user. Admins configure a threshold (how many identical messages trigger the rule) and a time window (how far back to look). Detection can be scoped per channel or server-wide.

For example, with a threshold of 3 and a window of 60 minutes, if a user sends the same message four times within an hour, the fourth message is deleted.

Monitored channels

The app acts on every text channel it has access to. There is no per-channel selection.

Roles and permissions

Moderation uses one permission group configured by community owners:

Role	Description
Moderation Admins	Users and roles who can access moderation settings and the audit log.

What admins can do

• View the dashboard, audit log, and analytics
• Configure content filter settings and manage word lists
• Configure spam detection
• Set analytics data retention

What other members can do

• View the dashboard and analytics (read-only)

Dashboard

The dashboard provides an overview of moderation activity in the last 24 hours. It displays two summary cards (Actions and Content Filtered), a Monitored Channels panel, and a list of recent activity showing the latest moderation events.

Audit log

The audit log is a searchable, paginated record of every moderation action. Admins can filter by:

• Username: search for actions targeting a specific member.
• Action type: All Actions, Delete Message, Kick, or Ban.
• Rule type: All Rules, Content Filter, or Spam Detection.

Each entry shows the time, action taken, target user, rule that triggered it, and the matched term (if applicable).

Analytics

The analytics view shows moderation trends over a selectable period (last 24 hours, 7 days, or 30 days). It includes:

• Summary cards with totals and percentage breakdowns.
• Actions over time: a stacked bar chart showing daily activity by rule type.
• Rule breakdown: a horizontal bar chart comparing content filter and spam actions.
• Top channels: the five most actioned channels.

Configure the content filter

Admins can manage the content filter from the Content Filter tab in settings.

1. Open settings and select the Content Filter tab.
2. Toggle Enable Content Filter to turn filtering on or off.
3. When enabled, toggle individual categories:
   • Filter Slurs: filter messages matching built-in slur terms.
   • Filter Profanity: filter messages matching built-in profanity terms.
   • Filter Custom Words: filter messages matching your custom word list.
   • Warn Users: send a public warning in the channel when a message is filtered.

Manage custom words

1. In the Content Filter tab, find the Banned Words section.
2. Type a word in the input field and select Add.
3. Select Show Banned Words to view and manage existing words.
4. Use the search field or category filter to find specific words.
5. Toggle a word on or off, or select the delete button to remove it.

Manage allowed words

1. In the Content Filter tab, find the Allowed Words section.
2. Type a word and select Add.
3. Words on this list are never filtered, even if they match a filter rule.

Configure spam detection

Admins can manage spam detection from the Spam Control tab in settings.

1. Open settings and select the Spam Control tab.
2. Toggle Enable Spam Detection to turn it on or off.
3. When enabled, configure:
   • Spam Threshold: number of identical messages before the rule triggers (2–10).
   • Time Window: how far back to look, in minutes (1–1,440).
   • Detection Scope: track per channel or server-wide.
   • Warn Users: send a public warning when spam is detected.

Configure data retention

Admins can set how long audit log entries are kept from the General tab in settings.

1. Open settings and select the General tab.
2. Set Analytics Retention to the desired number of days (7–365). The default is 30.
3. Entries older than the retention period are automatically deleted during daily cleanup.

Limits

Item	Limit
Custom word length	100 characters
Spam threshold	2–10
Spam time window	1–1,440 minutes
Analytics retention	7–365 days