> 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/settings.md).

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


---

# 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, and the optional `goal` query parameter:

```
GET https://securitybot.gitbook.io/securitybot-knowledge-hub/command-reference/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.