Skip to main content

Moderation App

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

note

Apps and Bots are only available on Desktop.

What is Moderation?

Moderation is a community app that helps leaders 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 three rule types in order: content filter, spam detection, and rate limiting. The first rule that triggers stops evaluation and the message is removed. All actions — automated and manual — are recorded in the audit log.

Content filter

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

CategoryDescription
SlursA built-in list of slur terms. Enabled by default.
ProfanityA built-in list of profanity terms. Enabled by default.
Custom wordsWords 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.

Rate limiting

Rate limiting prevents message flooding by capping how many messages a user can send in a given time window. When enabled, any message that exceeds the limit is deleted. Rate limiting is disabled by default.

Monitored channels

Community leaders choose which channels the app monitors. If no channels are selected, all channels are monitored.

Roles and permissions

Moderation uses one permission group configured by community leaders:

RoleDescription
Moderation AdminsUsers 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 and rate limiting
  • Take manual moderation actions (delete messages, kick, ban)
  • 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 three summary cards — total actions, content filtered, and manual actions — along with 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 — Delete Message, Kick, or Ban.
  • Rule type — Content Filter, Spam Detection, or Manual.
  • Date range — filter to a specific time period.

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

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, spam, and manual 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 Word List section.
  2. Type a word in the input field and select Add.
  3. Select Show Word List 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 rate limiting

Rate limiting settings are part of the app's server configuration. When enabled, admins set a maximum number of messages allowed within a time window.

SettingRangeDefault
Max messages3–5010
Time window (seconds)5–12010

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

ItemLimit
Custom word length100 characters
Spam threshold2–100
Spam time window1–1,440 minutes
Rate limit max messages3–50
Rate limit time window5–120 seconds
Analytics retention7–365 days