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

# Name-Filters

> Name-based filtering is the foundation of Hashbot’s protection system.

If a user joins your server — or changes their username or nickname — and it matches a blocked keyword, Hashbot will take immediate action.

<Tip>
  All of your name filters can be managed from the [Hashbot Dashboard](https://dashboard.hashbot.com) — add, remove, and review filters without using slash commands.
</Tip>

### View Your Current Blocklist

**Command**: `/name-filters list`
**Purpose**: Shows the total filter count (with phrase/regex breakdown) and a **"Manage on Dashboard"** button linking to [dashboard.hashbot.com](https://dashboard.hashbot.com) for full filter management.
**Example**: `/name-filters list`
**Prerequisites**: Manager role required

### Ongoing Blocklist Management

Maintaining your blocklist is a continuous process — not a one-time setup. While a **subscription** gives access to pre-built templates, unlimited filters, and fuzzy matching, **ongoing review** is critical.

New scams and impersonation tactics emerge often. To stay protected:

* Regularly update your list with new scam terms or impersonation attempts
* Add variations of names used by known bad actors
* Remove or refine filters that generate false positives

<Info>
  Over time, a well-maintained blocklist becomes more effective — reducing both manual moderation and false positives.
</Info>

<Warning>
  Add trusted users or roles to the [**Allowlist**](/allowlist) before enabling aggressive filters.\
  Otherwise, Hashbot may act on legitimate users unintentionally.
</Warning>

### Best Practices

* Assign the **Manager role** to trusted team members managing filters
* Use `/template` (Subscribers only) to import a curated base set of filters
* Supplement templates with community-specific entries
* Add critical roles (e.g., moderators, verified team) to the Allowlist via `/allowlist add @Role`
* Monitor your logs to catch missed threats or tune existing filters

## What's Next?

Now that you understand name filters, enhance your protection:

* **[Add Your First Filters](/name-filters/add-and-remove-filter)** - Learn how to add and remove filters
* **[Phrase vs Regex](/name-filters/phrase-and-regex)** - Choose the right filter type
* **[Test Your Filters](/name-filters/test-filters)** - Verify filters work as expected
* **[Enable Fuzzy Mode](/fuzzy-mode)** - Catch Unicode and symbol variants
* **[Run Cleanse](/cleanse)** - Scan existing members

## Related Topics

* **[Allowlist](/allowlist)** - Exempt trusted users from filters
* **[Templates](/templates)** - Apply pre-built filter collections
* **[PFP Protection](/pfp)** - Detect profile picture impersonation

### Need Help?

If you need support reviewing or refining your blocklist:\
[**Join our Discord**](https://discord.gg/hashbot) and open a ticket. Our team is happy to assist you.