# /user\_filters

{% hint style="info" %}
**Premium Feature** — User filters require a Premium subscription. [Compare plans →](https://securitybot.gitbook.io/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing)
{% endhint %}

Manage user protection settings for your server. This command contains **3 subcommand groups** for blocking nicknames, protecting user avatars, and configuring account age filtering.

***

## Subcommand Groups

* [`nickname`](#nickname-nickname-blocking) -- Block and unblock nicknames
* [`avatar`](#avatar-avatar-protection) -- Protect and unprotect user avatars
* [`age_filter`](#age_filter-account-age-filter) -- Configure account age filtering

***

## `nickname` -- Nickname Blocking

Block specific nicknames from being used in the server. Members who set a blocked nickname will be actioned automatically.

| Subcommand | Options                   | Description                                           |
| ---------- | ------------------------- | ----------------------------------------------------- |
| `block`    | `name` (String, required) | Block a nickname from being used                      |
| `unblock`  | `name` (String, required) | Remove a nickname from the blocklist                  |
| `view`     | None                      | Paginated list of all blocked nicknames (10 per page) |

### Example

```
/user_filters nickname block name: FakeAdmin
```

```
/user_filters nickname view
```

***

## `avatar` -- Avatar Protection

Protect a user's avatar from being copied by other members. When another member uses a protected avatar, they will be actioned automatically.

| Subcommand  | Options                 | Description                                           |
| ----------- | ----------------------- | ----------------------------------------------------- |
| `protect`   | `user` (User, required) | Protect a user's avatar                               |
| `unprotect` | `user` (User, required) | Remove avatar protection from a user                  |
| `view`      | None                    | Paginated list of all protected avatars (10 per page) |

### Example

```
/user_filters avatar protect user: @ProjectFounder
```

```
/user_filters avatar view
```

***

## `age_filter` -- Account Age Filter

Configure account age filtering to automatically action accounts that are too new.

| Subcommand   | Options | Description                              |
| ------------ | ------- | ---------------------------------------- |
| `age_filter` | None    | Configure account age filtering settings |

### Example

```
/user_filters age_filter
```

SecurityBot shows the current account age filter configuration with interactive controls:

* Toggle button to enable/disable the filter
* Dropdown to select minimum account age (1, 3, 7, 14, or 30 days)
* Dropdown to select action (Kick or Warn Only)

{% hint style="info" %}
When enabling the age filter for the first time, it defaults to 7 days minimum age and Warn Only action.
{% endhint %}

***

## Permissions

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