🧹 Filters
Block words and patterns with the Word Blacklist, and act on links, invites, attachments, excessive caps and emoji spam with Auto Filters. Each auto filter can delete the message only, or also warn, time out, kick or ban the sender, and can be limited to new members. Roles, members and domains that should never be filtered are set on the Whitelists tab.
Configuration
To configure filters:
- Open your workspace in the Fren One webapp.
- In the sidebar under Channels, select the Discord server you want to configure. Its pages open beneath it.
- Select Moderation, then the Filters tab.
The tab stacks three cards: Word Blacklist (with its Scope settings), Auto Filters, and New Member Definition. Exempt roles, whitelisted members and allowed domains live on their own Whitelists tab; the Word Blacklist and Auto Filters cards each link to it with Manage whitelists.
Word Blacklist
Blocks messages containing specific words, phrases, or patterns. Enter a "Word or pattern", pick a Match mode, and select Add: entries apply immediately.
| Match mode | Description |
|---|---|
| Partial | Blocks any message containing the text, even inside another word. Default. |
| Exact | Blocks the whole word only (word-boundary match). |
| Regex | Advanced: blocks messages matching the pattern (case-insensitive). |
In Regex mode you can type a regex directly, or describe the pattern in plain language (for example, "mentions of free nitro") and the agent generates one for you.
Added entries appear in three lists, "Exact words", "Partial matches" and "Regex patterns", and removing one takes effect immediately. Matching is case-insensitive in every mode.
Scope
The Scope settings control where the word filter applies. A Save button appears on them once you change something. Admins are always exempt.
| Option | Description |
|---|---|
| Apply in | All channels (default) or Only selected channels: the latter reveals a Channels picker. |
| Exempt channels | The word filter never runs in these channels. |
Auto Filters
Pre-built checks that act on matching messages. Each filter is a named rule with its own conditions, action, and channel scope. Select "Add Filter" to create one; existing rules can be toggled on and off directly from the list, or edited in the filter dialog.
| Condition | Matches |
|---|---|
| Contains a link | Any URL or bare domain. |
| Contains a Discord invite | discord.gg / invite links. |
| Has an attachment | Any image or file attachment. |
| Excessive caps | Messages that are over ~70% uppercase, on messages of 10+ characters. |
| Excessive emojis | More than 5 emojis, or emojis making up over 50% of the message. |
Select all conditions that apply: the action runs when any of them match.
| Option | Description |
|---|---|
| Name | A label for the filter, e.g. "No invites". Required. |
| Enabled | Turn the filter off without deleting it. |
| What should happen? | Delete message, Delete + warn, Delete + timeout, Delete + kick, or Delete + ban. |
| Timeout (seconds) | Shown for Delete + timeout. How long the member is timed out. Up to 28 days (2419200 seconds). |
| Apply in | All channels or Only selected: the latter reveals a Channels picker. |
| Exempt channels | This filter never runs in these channels. |
| Only apply to new members | Skip established members entirely. Who counts as "new" is set in the New Member Definition card. |
Deleting a filter asks for confirmation: the filter is permanently deleted.
New Member Definition
Defines who counts as a new member, used by any filter set to apply to new members only. A Save button appears on the card once you change something.
| Option | Description |
|---|---|
| Joined within (days) | Members who joined within this many days count as new. Default: 7. 0 = ignore join age. |
| Account age under (days) | Discord accounts younger than this count as new. Default: 0 (ignore account age). |
| Hasn't sent a message in the server yet | Counts members with no prior message in the server as new. |
| Combine the above with | OR: any rule (default): any rule marks them new. AND: all rules: all enabled rules must match. |
| Apply link filters to new members even on allowed domains | New members' links are filtered even when the domain is on the allowed list. |
Whitelists
Exempt roles, whitelisted members and allowed domains apply to the word blacklist and every auto filter. They're set on the Whitelists tab, not here: select Manage whitelists under either card to open it. See Whitelists.
How it works in Discord
When a message matches the word blacklist, the agent deletes it and posts a mod-log entry ("AutoMod: Blacklisted content filter"). Regex matching is case-insensitive, and invalid patterns are skipped rather than breaking the filter.
Auto filters delete the matching message first, then run the escalation: warn, timeout, kick, or ban. If Discord rejects the escalation because the agent lacks the permission or the member's role sits above the agent's, the action is not logged as a success, so your Mod Log reflects what actually happened.
The server owner, members with Discord Administrator, and holders of Agent Admin roles are always exempt from filters, on top of your Whitelists and any channels you exempt.
Saving your changes
This tab mixes save styles. Word blacklist entries apply immediately as you add or remove them. The Scope settings and the New Member Definition card each show their own Save button once you change something; until then there is nothing to save, so no button. Auto filters are saved from their editor dialog, and deleting one asks for confirmation first. Whitelists changes apply immediately on their own tab.
Tips
- Prefer Exact over Partial for short words: partial matches fire inside longer words (for example, "cat" matches "catalog").
- Add your official domains to Allowed domains on the Whitelists tab before enabling a link filter, so your own announcements aren't removed.
Troubleshooting
A filter isn't triggering?
- Check the filter's Enabled toggle and its channel scope: a filter never runs in its exempt channels.
- Admins, the server owner, and Agent Admin roles are always exempt; so are your Exempt roles and Whitelisted members on the Whitelists tab.
- If the filter is set to new members only, confirm the member still matches your New Member Definition.
The message is deleted but the timeout, kick, or ban isn't applied?
- If you've customized the agent's permissions, it needs the matching Discord permission (Moderate Members, Kick Members, Ban Members), and its role must sit above the target member's roles.
- Timeouts cap at Discord's 28-day maximum.
A link from an allowed domain was still removed?
- Check "Apply link filters to new members even on allowed domains": new members' links bypass the allowed list when it's on.
Related features
- 🛡️ AutoMod (Discord native): Discord-enforced rules that keep working even when the agent is offline
- 🔫 Triggers: Respond to custom phrases with messages and moderation actions
- ✅ Whitelists: Roles, members and domains the word blacklist, filters and AI spam removal never action
- 🤖 Spam & Impersonation: AI-powered spam detection for new members
- 👤 User Blacklist: Screen members at join, before they can post at all