# /settings

{% hint style="success" %}
**Available on all tiers** — Some settings only apply to Premium features.
{% endhint %}

Configure SecurityBot's core settings. Use `/settings view` for an overview with quick-toggle buttons, or use individual subcommands to change specific settings.

***

## Usage

| Subcommand            | Options                           | Permission | Description                                               |
| --------------------- | --------------------------------- | ---------- | --------------------------------------------------------- |
| `view`                | None                              | Admin      | Shows current settings overview with quick-toggle buttons |
| `usage`               | None                              | Admin      | View your tier and current usage against free tier limits |
| `logs`                | `channel` (TextChannel, required) | Admin      | Set the log channel for SecurityBot notifications         |
| `chat_alerts enable`  | None                              | Admin      | Enable chat alert notifications                           |
| `chat_alerts disable` | None                              | Admin      | Disable chat alert notifications                          |
| `dms disable`         | None                              | Admin      | Disable member-to-member DMs server-wide (Premium)        |
| `dms enable`          | None                              | Admin      | Re-enable member-to-member DMs (Premium)                  |
| `2fa register`        | None                              | Moderator+ | Register for 2FA on this server                           |
| `2fa deregister`      | None                              | Moderator+ | Deregister from 2FA on this server                        |

### Example

```
/settings usage
```

```
/settings logs channel: #security-logs
```

```
/settings 2fa register
```

***

## Subcommand Details

### `/settings view`

Displays the current configuration at a glance: log channel, chat alerts status (enabled/disabled), and your 2FA registration status. Includes interactive buttons for quick toggles directly from the view.

### `/settings usage`

Shows your server's current tier and usage against free tier limits. The response is ephemeral (only visible to you).

**Free tier** servers see a progress bar for each capped metric:

* Filter Actions Today (10/day)
* Domain Allowlist (20 entries)
* Address Allowlist (5 entries)
* Handle Allowlist (5 entries)
* Invite Allowlist (5 entries)

Metrics that have reached their cap display a warning indicator.

**Premium** servers see a confirmation that all features are unlimited with no caps.

### `/settings logs`

Sets the channel where SecurityBot sends log notifications (filter violations, scammer alerts, purge results, etc.). SecurityBot validates that it has MESSAGE\_SEND permission in the target channel and sends a confirmation message to the new log channel.

### `/settings chat_alerts enable` / `disable`

Toggles chat alert notifications on or off for your server.

### `/settings dms disable` / `enable`

Toggles member-to-member DMs on or off for your server. When disabled, SecurityBot automatically re-applies the restriction every 24 hours. Requires a Premium subscription, a Community server, and the Manage Server permission.

### `/settings 2fa register`

Starts the 2FA registration flow:

1. SecurityBot shows a registration splash with a QR code and secret key.
2. Scan the QR code with an authenticator app.
3. A modal prompts you to enter a TOTP code to verify.
4. Once verified, you are registered for 2FA on that server.

### `/settings 2fa deregister`

Starts the 2FA deregistration flow:

1. SecurityBot shows a deregistration confirmation splash.
2. A modal prompts you to enter your current TOTP code to confirm.
3. Your 2FA registration for that server is removed.

***

## Permissions

* **`/settings view`** -- Administrator
* **`/settings usage`** -- Administrator
* **`/settings logs`** -- Administrator
* **`/settings chat_alerts` (all)** -- Administrator
* **`/settings dms` (all)** -- Administrator (Premium, Community server required)
* **`/settings 2fa` (all)** -- Moderator+