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