# Command Migration Guide

SecurityBot's command surface has been restructured. The old system had many separate top-level commands; the new system consolidates everything into **11 top-level slash commands** with subcommands. This page helps you find the new equivalent of any legacy command.

***

## Old to New Command Mapping

| Legacy Command                   | New Command                          | Notes                                          |
| -------------------------------- | ------------------------------------ | ---------------------------------------------- |
| `/allow_address`                 | `/chat_filters address add`          |                                                |
| `/block_nickname`                | `/user_filters nickname block`       |                                                |
| `/check_subscription`            | `/about`                             | Renamed                                        |
| `/flag_user`                     | `/scammers flag`                     |                                                |
| `/lock create`                   | `/lock create`                       | Now supports 2FA locks in addition to password |
| `/lock remove`                   | `/lock remove`                       | No change                                      |
| `/lock toggle`                   | `/lock toggle`                       | No change                                      |
| `/lock update`                   | `/lock update`                       | No change                                      |
| `/protect_avatar`                | `/user_filters avatar protect`       |                                                |
| `/remove_address`                | `/chat_filters address remove`       |                                                |
| `/settings block_addresses`      | `/chat_filters address toggle`       | Moved to chat\_filters                         |
| `/unblock_nickname`              | `/user_filters nickname unblock`     |                                                |
| `/view_all [Allowed Addresses]`  | `/chat_filters address view`         | See below                                      |
| `/view_all [Blocked Domains]`    | `/chat_filters domain view`          | See below                                      |
| `/view_all [Blocked Handles]`    | `/chat_filters handle view`          | See below                                      |
| `/view_all [Allowed Invites]`    | `/chat_filters invite view`          | See below                                      |
| `/view_all [Blocked Names]`      | `/user_filters nickname view`        | See below                                      |
| `/view_all [Ignored Categories]` | `/chat_filters exempt_category view` | See below                                      |
| `/view_all [Ignored Channels]`   | `/chat_filters exempt_channel view`  | See below                                      |
| `/view_all [Protected Avatars]`  | `/user_filters avatar view`          | See below                                      |
| `/view_all [Exempt Roles]`       | `/roles view`                        | See below                                      |

***

## `/view_all` Decomposition

The legacy `/view_all` command was a single command with multiple options for viewing different lists. Each of these is now a dedicated `view` subcommand under the appropriate command group:

| Legacy `/view_all` Option | New Location                         |
| ------------------------- | ------------------------------------ |
| Allowed Addresses         | `/chat_filters address view`         |
| Blocked Domains           | `/chat_filters domain view`          |
| Blocked Handles           | `/chat_filters handle view`          |
| Allowed Invites           | `/chat_filters invite view`          |
| Blocked Names             | `/user_filters nickname view`        |
| Protected Avatars         | `/user_filters avatar view`          |
| Ignored Channels          | `/chat_filters exempt_channel view`  |
| Ignored Categories        | `/chat_filters exempt_category view` |
| Exempt Roles              | `/roles view`                        |

***

## Removed Commands

The following legacy commands have been removed with no direct replacement:

| Legacy Command | Reason                           |
| -------------- | -------------------------------- |
| `/scam_search` | Removed from the command surface |

***

## New Commands

These commands are new and have no legacy equivalent:

| Command                    | Description                                                  |
| -------------------------- | ------------------------------------------------------------ |
| `/help`                    | Links to Knowledge Hub and support server                    |
| `/roles`                   | Dedicated command for managing permission roles              |
| `/user_filters`            | Nickname blocking, avatar protection, and account age filter |
| `/user_filters age_filter` | Account age filtering configuration                          |


---

# 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/command-migration.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.