> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Blacklisted Words

> Create a custom filter for profanity, slurs, or unwanted phrases.

The **Blacklist Word** filter is a customizable Automod module that allows you to define specific words or phrases that are not allowed in your server. If a member types a blacklisted word, their message is instantly deleted and they are punished according to your Automod settings.

<Note>
  **Required Permission:** `is_server_owner` — Only the Server Owner and Extra Owners can manage blacklisted words.
</Note>

***

## Commands

All commands for this filter are located under the `.blword` group.

| Command                 | Description                              |
| :---------------------- | :--------------------------------------- |
| `.blword add <word>`    | Adds a word or phrase to the blacklist   |
| `.blword remove <word>` | Removes a word from the blacklist        |
| `.blword show`          | Displays all currently blacklisted words |
| `.blword reset`         | Removes all words from the blacklist     |
| `.blword guide`         | Shows a quick reference guide in chat    |

***

## Adding Multiple Words

You can add multiple words at once by separating them with commas.

```bash theme={null}
.blword add badword1, badword2, bad phrase
```

<Warning>
  The Blacklist Word filter uses **substring matching**. This means if you blacklist the word "ear", the bot will also flag and delete "h**ear**", "b**ear**", and "t**ear**".

  Be very careful to only blacklist unique words or phrases to avoid false positives!
</Warning>