Message Filtering Commands

Advanced content filtering to keep your server safe and clean.

Filter Severity Levels

The filter has three levels of severity that determine how violations are handled:

Minor - Logs the message in mod logs only
Moderate - Deletes the message and flags an automod warning
Severe - Deletes the message, flags a warning, and mutes the user for 5 hours

Automatic Actions

Automatic Actions allow you to take consistent, escalating action against users who repeatedly trigger filters. These are managed via the Automod & Filters dashboard.

Key Concepts

Trigger Level: The number of times a user must trigger a filter before the action is taken.
Scaling Multiplier: Multiplies the punishment duration on repeat offenses. For example, a 10m mute with a 2.0x multiplier will become 20m, then 40m, etc.
Re-offense Window: The period of time the bot "remembers" the previous violation for scaling purposes.
Execution Lock: To prevent "scaling storms," the bot has a 10-second lock per user. This ensures that a single burst of 10 messages only triggers one auto-action.

Managing Rule

Moderators can view a user's current trigger history and reset their scaling level using the Member Automod Status lookup on the dashboard or via the /automod-member command.

Word Filter

filter word add

Adds a word to the message filter.

Usage:

/filter word add [word] [severity: Minor/Moderate/Severe]

Example:

/filter word add dynobot Minor

Severity Options:

Minor - Logs only, message stays
Moderate - Deletes message, warns user
Severe - Deletes, warns, mutes for 5 hours

Required Role: Moderator

Multiple Words

You can add multiple variations of words to catch similar phrases.

filter word remove

Removes a word from the active filter.

Usage:

/filter word remove [word]

Example:

/filter word remove dynobot

Required Role: Moderator

filter word list

Generates a complete list of all currently filtered words.

Usage:

/filter word list

Output:

Shows all filtered words
Displays severity level for each word
Sent to the moderator log channel

Required Role: Moderator

Advanced Word Filter Protections

Configure how aggressive the word filter should be. These settings are managed via the web dashboard.

Feature	Description
Leetspeak	Detects character substitutions (e.g., `f*ck`, `@ss`)
Homoglyphs	Normalizes look-alike characters from other alphabets
Separators	Detects words with symbols between letters (e.g., `s.h.i.t`)
Duplicate Letters	Catches stretched words (e.g., `caaaat` -> `cat`)
Headers	Blocks messages using markdown headers (e.g., `# Header`)
Subtext	Blocks messages using markdown subtext (e.g., `-# Small text`)
Masked Links	Blocks masked markdown links (e.g., `[text](url)`)
Workarounds	Extreme normalization to catch `w o r d` style bypasses

Invite Filter

filter invite toggle

Turns the invite link filter on or off.

Usage:

/filter invite toggle

Effect:

Prevents users from posting Discord invite links
Helps prevent server poaching and unauthorized promotions

Required Role: Moderator

filter invite whitelist-add

Adds an invite link or server to the whitelist (allow list).

Usage:

/filter invite whitelist-add [invite]

Example:

/filter invite whitelist-add discord.gg/example

Notes:

Whitelisted invites will NOT be filtered
Useful for official community servers or partner servers

Required Role: Moderator

filter invite whitelist-remove

Removes an invite from the whitelist.

Usage:

/filter invite whitelist-remove [invite]

Example:

/filter invite whitelist-remove discord.gg/example

Required Role: Moderator

filter invite whitelist-list

Lists all whitelisted invites.

Usage:

/filter invite whitelist-list

Output:

Shows all whitelisted invite codes/links
Sent to the moderator log channel

Required Role: Moderator

filter invite server-whitelist-add

Adds a server ID to the whitelist. Any invite link that resolves to this server (no matter the specific code) will be allowed.

Usage:

/filter invite server-whitelist-add [server_id] [nickname: optional]

Example:

/filter invite server-whitelist-add 1178595123408424990 Partner Server

Notes:

server_id must be a numeric Discord snowflake
nickname is a friendly name for your own organization on the dashboard/list
The bot resolves invite links to check their target server ID against this list

Required Role: Moderator

filter invite server-whitelist-remove

Removes a server ID from the whitelist.

Usage:

/filter invite server-whitelist-remove [server_id]

Example:

/filter invite server-whitelist-remove 1178595123408424990

Required Role: Moderator

filter invite server-whitelist-list

Lists all whitelisted server IDs and their friendly nicknames.

Usage:

/filter invite server-whitelist-list

Output:

Shows all whitelisted server IDs and nicknames
Sent to the moderator log channel

Required Role: Moderator

Smart Filtering

Intelligent content filtering using AI/ML models.

filter smart configure

Enables or disables smart content filters.

Usage:

/filter smart configure [type]

Available Types:

Adult Content - Filters NSFW/adult content
Malware - Filters potential malware links

Example:

/filter smart configure Adult Content

Notes:

Uses advanced detection algorithms
Can be toggled on/off as needed

Required Role: Moderator

filter smart nsfw-exception

Allows adult content in NSFW channels even when the adult filter is enabled.

Usage:

/filter smart nsfw-exception

Effect:

Toggles NSFW channel exception
When enabled, NSFW channels bypass adult content filter
Useful if you have designated adult content areas

Required Role: Moderator

Organization

Use NSFW channels for adult content rather than filtering it across the entire server.

Emoji & Sticker Filters

filter emoji toggle

Toggles filtering of external (animated/custom) emojis.

Usage:

/filter emoji toggle

Effect:

When enabled, prevents posting of emojis not from your server
Reduces clutter from external emoji spam
Users can still use server emojis

Required Role: Moderator

filter sticker toggle

Toggles filtering of external stickers.

Usage:

/filter sticker toggle

Effect:

When enabled, prevents posting of stickers not from your server
Helps maintain a clean sticker experience
Users can still use server stickers

Required Role: Moderator

Mention Prevention

Prevent users from pinging specific people, roles, or members who possess specific roles. Staff members are exempt from these restrictions.

filter mention toggle

Toggles the entire mention filter on or off.

Usage:

/filter mention toggle

Required Role: Moderator

filter mention add-user

Blocks mentions of a specific user.

Usage:

/filter mention add-user [user]

Example:

/filter mention add-user @Wumpus

Required Role: Moderator

filter mention remove-user

Removes a user from the mention blocklist.

Usage:

/filter mention remove-user [user]

Required Role: Moderator

filter mention add-role

Blocks mentions of a specific role (e.g., prevents pinging @Developer).

Usage:

/filter mention add-role [role]

Required Role: Moderator

filter mention remove-role

Removes a role from the mention blocklist.

Usage:

/filter mention remove-role [role]

Required Role: Moderator

filter mention add-member-role

Blocks mentions of any user who holds a specific role. This is useful for protecting all staff members or specific groups from being pinged.

Usage:

/filter mention add-member-role [role]

Example:

/filter mention add-member-role @Staff

Required Role: Moderator

filter mention remove-member-role

Removes a role from the protected member-role list.

Usage:

/filter mention remove-member-role [role]

Required Role: Moderator

filter mention list

Displays a list of all currently blocked users, roles, and protected roles.

Usage:

/filter mention list

Required Role: Moderator

Read-Only Mode

filter readonly toggle

Toggles server-wide read-only mode for non-staff users.

Usage:

/filter readonly toggle

Effect:

Deletes non-staff messages while enabled
Deletes newly created non-staff threads
Removes non-staff reactions as they are added
Disconnects non-staff users who join voice channels

Required Role: Moderator

Filter Management Tips

Start Broad - Begin with severe violations
Monitor Logs - Check what gets filtered
Adjust Severity - Modify severity levels based on false positives
Whitelist Carefully - Only whitelist trusted invites
Communicate - Let your community know your filter rules

False Positives

Monitor your filtered words list for innocent words that might get caught. For example, common words in names or slang.