> 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/command-reference/user-filters.md).

# /user\_filters

{% hint style="info" %}
**Premium Feature** — User filters require a Premium subscription. [Compare plans →](/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing.md)
{% 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.


---

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

```
GET https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/user-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.