# /chat\_filters

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

Manage all of SecurityBot's chat filtering settings from a single command. This command contains **6 subcommand groups**, each controlling a different filter type or exemption.

***

## Subcommand Groups

* [`address`](#address-cryptocurrency-address-filter) -- Cryptocurrency address allowlist
* [`domain`](#domain-domain-link-filter) -- Domain/link blocklist
* [`handle`](#handle-ada-handle-filter) -- ADA handle blocklist
* [`invite`](#invite-discord-invite-filter) -- Discord invite allowlist
* [`exempt_channel`](#exempt_channel-exempt-channels) -- Channels exempt from filters
* [`exempt_category`](#exempt_category-exempt-categories) -- Categories exempt from filters

***

## `address` -- Cryptocurrency Address Filter

Controls which cryptocurrency addresses are allowed in chat. When enabled, messages containing addresses not on the allowlist are deleted.

| Subcommand | Options                      | Description                                 |
| ---------- | ---------------------------- | ------------------------------------------- |
| `about`    | None                         | View address filter status and information  |
| `add`      | `address` (String, required) | Add an address to the allowlist             |
| `remove`   | `address` (String, required) | Remove an address from the allowlist        |
| `toggle`   | None                         | Toggle address filtering on/off             |
| `view`     | None                         | Paginated list of all whitelisted addresses |

### Supported Address Formats

* **Ethereum:** `0x` prefix (42 characters)
* **Cardano:** `addr1` prefix
* **Bitcoin:** `1`, `3`, or `bc1` prefix

### Example

```
/chat_filters address add address: 0x1234abcd5678ef901234abcd5678ef9012345678
```

```
/chat_filters address toggle
```

***

## `domain` -- Domain/Link Filter

Controls which domains are blocked in chat. When enabled, messages containing links to blocked domains are deleted.

| Subcommand | Options                     | Description                               |
| ---------- | --------------------------- | ----------------------------------------- |
| `about`    | None                        | View domain filter status and information |
| `add`      | `domain` (String, required) | Add a domain to the blocklist             |
| `remove`   | `domain` (String, required) | Remove a domain from the blocklist        |
| `toggle`   | None                        | Toggle domain filtering on/off            |
| `view`     | None                        | Paginated list of all blocked domains     |

### Example

```
/chat_filters domain add domain: suspicious-site.com
```

***

## `handle` -- ADA Handle Filter

Controls which ADA handles (Cardano naming service) are blocked in chat.

| Subcommand | Options                     | Description                               |
| ---------- | --------------------------- | ----------------------------------------- |
| `about`    | None                        | View handle filter status and information |
| `add`      | `handle` (String, required) | Add an ADA handle to the blocklist        |
| `remove`   | `handle` (String, required) | Remove an ADA handle from the blocklist   |
| `toggle`   | None                        | Toggle handle filtering on/off            |
| `view`     | None                        | Paginated list of all blocked handles     |

{% hint style="info" %}
Handle input is validated for correct ADA handle format.
{% endhint %}

### Example

```
/chat_filters handle add handle: $fakeminthandle
```

***

## `invite` -- Discord Invite Filter

Controls which Discord server invites are allowed in chat. When enabled, messages containing invite links not on the allowlist are deleted.

| Subcommand | Options                     | Description                               |
| ---------- | --------------------------- | ----------------------------------------- |
| `about`    | None                        | View invite filter status and information |
| `add`      | `invite` (String, required) | Add an invite to the allowlist            |
| `remove`   | `invite` (String, required) | Remove an invite from the allowlist       |
| `toggle`   | None                        | Toggle invite filtering on/off            |
| `view`     | None                        | Paginated list of all whitelisted invites |

{% hint style="info" %}
You can provide either a full invite URL (e.g., `discord.gg/abc123`) or just the invite code (`abc123`). Invite links are resolved to their target server.
{% endhint %}

### Example

```
/chat_filters invite add invite: discord.gg/securitybot
```

***

## `exempt_channel` -- Exempt Channels

Channels where chat filters are not enforced.

| Subcommand | Options                       | Description                            |
| ---------- | ----------------------------- | -------------------------------------- |
| `about`    | None                          | View exempt channel configuration info |
| `add`      | `channel` (Channel, required) | Add a channel to exemptions            |
| `remove`   | `channel` (Channel, required) | Remove a channel from exemptions       |
| `view`     | None                          | Paginated list of all exempt channels  |

{% hint style="info" %}
**Free tier limit:** Up to 3 exempt channels. Premium: unlimited. [Free tier details →](/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing/free-tier-limits.md)
{% endhint %}

### Example

```
/chat_filters exempt_channel add channel: #bot-commands
```

***

## `exempt_category` -- Exempt Categories

Channel categories where chat filters are not enforced. Applies to all channels within the category.

| Subcommand | Options                        | Description                             |
| ---------- | ------------------------------ | --------------------------------------- |
| `about`    | None                           | View exempt category configuration info |
| `add`      | `category` (Channel, required) | Add a category to exemptions            |
| `remove`   | `category` (Channel, required) | Remove a category from exemptions       |
| `view`     | None                           | Paginated list of all exempt categories |

{% hint style="warning" %}
**Premium only.** Exempt categories are not available on the free tier. Use `exempt_channel` to exempt individual channels (up to 3 on the free tier). [Compare plans →](/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing.md)
{% endhint %}

### Example

```
/chat_filters exempt_category add category: Staff Channels
```

***

## Permissions

**Administrator** -- All subcommands require the SecurityBot admin role, Discord ADMINISTRATOR permission, or server ownership.


---

# Agent Instructions: 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:

```
GET https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/chat-filters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.