Skip to main content

🔤 Word Blacklist

The Word Blacklist feature allows moderators and community leads to automatically remove messages containing specific blacklisted words. This feature helps maintain the quality of conversations and ensures that inappropriate or unwanted terms are not used in the group.

Overview​

By configuring a list of prohibited words, the bot will automatically detect and delete any messages containing those terms. This proactive approach helps prevent spam, scams, inappropriate language, and other unwanted content from appearing in your community.

Configuration​

To access Word Blacklist settings:

  1. Use the /settings command in your chat
  2. Navigate to 🛡️ Moderation → 🔤 Word Blacklist
  3. Manage your blacklisted words using the available options

Managing Word Blacklist Settings​

View Blacklisted Words​

The current list of words that are blacklisted is displayed in the 🔤 Word Blacklist menu.

Add Word(s)​

Allows admins to add new words to the blacklist.

Regular expressions must be prefaced with r:, e.g., r: .admin."

Multiple Words at Once

Separate multiple words or phrases with commas to add them all in one go. This saves time when setting up your blacklist.

Example input:

scam, rug pull, airdrop

Regular Expressions Support​

You can also use regular expressions here to catch words that are:

  • Parts of sentences
  • Begin with specific words
  • Match specific patterns
  • Include variations and misspellings
🤖Regex Generator
Create regex for:
Advanced Pattern Matching

Regular expressions allow you to create powerful filters that catch variations of words and complex patterns. Learn more about regex syntax online before implementing complex patterns.

Remove Word(s)​

Removes words from the blacklist.

When to use:

  • Word is no longer problematic
  • False positives are occurring
  • Community standards have changed
  • Temporary restrictions are lifted

How Word Blacklist Works​

  1. User sends a message containing a blacklisted word or pattern
  2. Bot detects the match against the blacklist
  3. Message is automatically deleted from the chat
Instant Deletion

Messages containing blacklisted words are deleted immediately. Ensure your blacklist is accurate to avoid removing legitimate messages.

Best Practices​

Effective Word Blacklist Management
  • Start with obvious problematic words
  • Add words gradually based on observed issues
  • Use regex for catching variations (e.g., sc@m, sc4m)
  • Review and update the list regularly
  • Test patterns to avoid false positives
  • Document why each word is blacklisted (internally)
  • Consider cultural and linguistic variations
  • Balance between protection and over-moderation

Admin Commands​

CommandDescription
/blacklist [word/pattern]Add a word or pattern to the blacklist
/unblacklist [word/pattern]Remove a word or pattern from the blacklist
tip

You can manage blacklist entries directly in chat without opening the settings menu. Regular expressions are supported — prefix with r: (e.g., r:.*scam.*).

Avoiding False Positives
  • Be careful with common words that might appear in legitimate contexts
  • Test blacklist patterns before deploying
  • Use specific phrases rather than single common words
  • Monitor for legitimate messages being deleted
  • Provide alternative ways for users to discuss necessary topics
  • Consider whitelisting trusted users who need to discuss blacklisted terms
  • Use partial matching carefully to avoid catching unintended words
Troubleshooting

Blacklist not working?

  • Verify the Word Blacklist feature is enabled
  • Check if bot has permission to delete messages
  • Ensure bot has admin privileges
  • Test with a known blacklisted word

Legitimate messages being deleted?

  • Review your blacklist for overly broad terms
  • Check regex patterns for unintended matches
  • Add exceptions for trusted users via User Whitelist

Users bypassing blacklist?

  • Add common character substitutions to your patterns
  • Use regex to catch variations
  • Monitor for new bypass methods
  • Update blacklist regularly

Regex not working as expected?

  • Test regex patterns in an online regex tester
  • Ensure proper escaping of special characters
  • Verify the regex syntax is correct
  • Start simple and gradually add complexity

Too many words to manage?

  • Focus on highest-impact words first
  • Use regex patterns to consolidate similar terms
  • Regular review and cleanup of outdated entries

On this page