# /chat\_filters

{% hint style="info" %}
**Available on all tiers** — Free tier: 10 filtered actions per day, limited allowlist entries. Premium: unlimited. [Compare plans →](https://securitybot.gitbook.io/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing)
{% 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 →](https://securitybot.gitbook.io/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing/free-tier-limits)
{% 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 →](https://securitybot.gitbook.io/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing)
{% 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.