> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volvox.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Bot Settings and Dashboard Settings

> Configure Volvox.Bot for your Discord server from the web dashboard, with per-feature settings, role access, and no config files or restarts.

# Bot settings

All server configuration lives in the dashboard under **Settings**. No config files, no environment variables, no restarts.

## How it works

You can edit server settings through the dashboard. The dashboard saves changes through the bot API, and the bot picks up new config on the next config refresh.

<Callout type="tip">
  Use the dashboard search to quickly find a specific setting.
</Callout>

## Shareable tab URLs

Every settings category and feature tab has its own URL. Bookmark or share a link to open the dashboard on the exact tab you want. Switching tabs updates the address bar with a `?tab=` query parameter, and browser back and forward walk through your tab history.

The URL pattern is:

```text theme={null}
https://volvox.bot/dashboard/settings/<category>?tab=<feature>
```

For example, the Link filter is inside the **Moderation** tab at `/dashboard/settings/moderation-safety?tab=moderation`. Open `/dashboard/settings` and Volvox.Bot redirects you to the default **AI & Automation** category.

## Settings tabs

| Section                    | What you can configure                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **AI & Automation**        | AI chat, per-channel AI modes, triage, model routing, and memory                                                         |
| **Onboarding & Growth**    | Welcome messages, rules verification, introductions, XP, level-up actions, and engagement badges                         |
| **Moderation & Safety**    | Content safety, spam detection, moderation actions, warning rules, permissions, protected roles, and audit log retention |
| **Community Tools**        | Command prefix, starboard highlights, and TL;DR summaries                                                                |
| **Support & Integrations** | Ticket mode, ticket panels, staff roles, limits, and transcript channels                                                 |

| Dashboard tab                         | Route                                                        | Feature docs                                                                        |
| ------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| AI & Automation -> AI Chat            | `/dashboard/settings/ai-automation?tab=ai-chat`              | [AI Chat settings](/features/ai-conversations#ai-chat-settings)                     |
| AI & Automation -> Triage             | `/dashboard/settings/ai-automation?tab=triage`               | [AI triage settings](/features/moderation#ai-triage-settings)                       |
| AI & Automation -> Memory             | `/dashboard/settings/ai-automation?tab=memory`               | [Memory settings](/features/ai-conversations#memory-settings)                       |
| Onboarding & Growth -> Welcome        | `/dashboard/settings/onboarding-growth?tab=welcome`          | [Welcome settings](/features/welcome#welcome-settings)                              |
| Onboarding & Growth -> Engagement     | `/dashboard/settings/onboarding-growth?tab=engagement`       | [Engagement settings](/features/community#engagement-settings)                      |
| Onboarding & Growth -> Reputation     | `/dashboard/settings/onboarding-growth?tab=reputation`       | [Reputation settings](/features/community#reputation-settings)                      |
| Onboarding & Growth -> Level Actions  | `/dashboard/settings/onboarding-growth?tab=xp-level-actions` | [Level-up actions](/features/community#level-up-actions)                            |
| Moderation & Safety -> Content Safety | `/dashboard/settings/moderation-safety?tab=ai-automod`       | [AI auto-moderation settings](/features/moderation#ai-auto-moderation-settings)     |
| Moderation & Safety -> Spam Detection | `/dashboard/settings/moderation-safety?tab=spam-detection`   | [Spam detection settings](/features/moderation#spam-detection-settings)             |
| Moderation & Safety -> Moderation     | `/dashboard/settings/moderation-safety?tab=moderation`       | [Classic moderation settings](/features/moderation#classic-moderation-settings)     |
| Moderation & Safety -> Warning Rules  | `/dashboard/settings/moderation-safety?tab=warning-rules`    | [Warning expiry and escalation](/features/moderation#warning-expiry-and-escalation) |
| Moderation & Safety -> Permissions    | `/dashboard/settings/moderation-safety?tab=permissions`      | [Permissions settings](/configuration/permissions#permissions-settings)             |
| Moderation & Safety -> Audit Log      | `/dashboard/settings/moderation-safety?tab=audit-log`        | [Audit Log settings](/features/audit-log#audit-log-settings)                        |
| Community Tools -> Commands           | `/dashboard/settings/community-tools?tab=commands`           | [Command prefix](#command-prefix)                                                   |
| Community Tools -> Starboard          | `/dashboard/settings/community-tools?tab=starboard`          | [Starboard](/features/community#starboard)                                          |
| Community Tools -> TL;DR              | `/dashboard/settings/community-tools?tab=tldr`               | [TL;DR settings](/features/tldr#tldr-settings)                                      |
| Support & Integrations -> Tickets     | `/dashboard/settings/support-integrations?tab=tickets`       | [Ticket settings](/features/tickets#ticket-settings)                                |

## Command prefix

Set a text command prefix under **Settings -> Community Tools -> Commands**. A prefix can be one to five non-space characters, such as `.`, `!`, or `?`. Leave the field blank to disable prefix commands and keep slash-only behavior.

Prefix commands are an alias layer over slash commands — they reuse the exact same command names, options, and permission gates. A member who cannot run `/ban` also cannot run `!ban`, and a moderator who can run `/timeout` can run it either way.

### When to use a prefix

* Members on mobile or older clients prefer typing over the slash command picker.
* You want quick, one-handed moderation actions during a raid.
* Your community already uses a familiar prefix from a previous bot.

### Allowed characters

* One to five characters
* No spaces, `/`, `@`, `#`, `<`, `>`, or backticks. Those collide with mentions, channels, or Markdown.
* Common examples: `.`, `!`, `?`, `$`, `!!`, `..`

### Example

With the prefix set to `!`, both calls below run the same handler and produce the same result:

```text theme={null}
/ban user:@spammer reason:advertising
!ban @spammer advertising
```

Quote arguments with spaces, just like a shell:

```text theme={null}
!timeout @spammer 10m "spamming invite links"
```

If a member runs a prefix command they don't have permission for, the bot replies with the same permission error it sends for slash commands.

## Saving changes

Settings are per-server. Each Discord server you add Volvox.Bot to has its own independent configuration.

When you change settings, the dashboard shows a save bar with the pending changes. Save when you are ready, or discard changes to return to the last saved config.

<Callout type="info">
  The legacy `/dashboard/config` route redirects to `/dashboard/settings`.
</Callout>
