> For the complete documentation index, see [llms.txt](https://securitybot.gitbook.io/securitybot-knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://securitybot.gitbook.io/securitybot-knowledge-hub/bot-guide/chat-filters/ada-handle-filter.md).

# ADA Handle Filter

{% hint style="info" %}
**Available on all tiers** — Free tier: 10 filtered actions per day, 5 allowlisted handles. Premium: unlimited. [Compare plans →](/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing.md)
{% endhint %}

SecurityBot’s ADA Handle filter helps prevent phishing, impersonation, and scam attempts by blocking any **unapproved ADA Handles** posted in chat.

By default, **all ADA Handles are blocked** unless explicitly allowed. This ensures only trusted handles—such as your project’s official handles—can be shared in your community.

***

## How to Manage ADA Handles

### Enable or disable the ADA handle filter

The filter is enabled by default, meaning all ADA Handles are blocked unless approved. You can toggle the filter on or off using:

```
/settings block_handles
```

* When enabled, any ADA Handle not on the allowlist will be removed from chat.
* When disabled, ADA Handles will not be filtered.

A confirmation message will appear indicating whether ADA Handle filtering is currently **enabled** or **disabled**.

***

### Allow a specific handle

To whitelist a handle you want users to be allowed to share in chat:

```
/allow_handle [handle]
```

Example:

```
/allow_handle $securitybot
```

This adds the handle to your allowlist. Messages containing that handle will no longer be blocked.

***

### Remove a handle from the allowlist

To revoke permission for a previously approved handle:

```
/remove_handle [handle]
```

Example:

```
/remove_handle $securitybot
```

Once removed, messages containing the handle will again be blocked (if filtering is enabled).

***

### View all allowed handles

To review which ADA Handles are currently approved:

```
/chat_filters handle view
```

Select **"Allowed Handles"** from the options to view your current allowlist in an embed.

***

### Best Practices

* Only allow ADA Handles that belong to your team, partners, or trusted projects
* Use `/chat_filters handle view` regularly to audit the allowlist
* Combine with **name blocking** and **link filtering** for stronger protection

{% hint style="info" %}
Only users with the admin role or Discord’s Administrator permission can manage the ADA Handle filter.
{% endhint %}

***

Next up: Learn how to stop unwanted and suspicious links with [Link Filters](/securitybot-knowledge-hub/bot-guide/chat-filters/link-filter.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://securitybot.gitbook.io/securitybot-knowledge-hub/bot-guide/chat-filters/ada-handle-filter.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.