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

# Discord command reference

> Exact slash command behavior, permissions, and expected responses.

## Command availability

Verba can register these slash commands:

* `/activate-channel`
* `/remove-channel`
* `/reset`
* `/generate`
* `/dashboard`
* `/vc-join`
* `/vc-leave`
* `/ping`

Each command can be toggled on/off in your Discord module settings.

<Note>
  This page covers Verba's built-in Discord slash commands. Custom-builder slash
  commands are documented separately in the
  [Discord Custom Builder](/guides/custom-builder) guide.
</Note>

<Note>
  Discord activity and presence editing are not plan-locked. `/vc-join` and
  `/vc-leave` can stay enabled on any plan, but live voice-channel speaking
  still requires `Ultra`. On lower tiers, the bot returns an in-character
  upgrade response instead of joining VC. Normal generated voice messages
  remain free.
</Note>

## Permission matrix

| Command             | Where     | Permission requirement                                                                                                 |
| ------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- |
| `/activate-channel` | Server    | Administrator                                                                                                          |
| `/remove-channel`   | Server    | Administrator                                                                                                          |
| `/reset`            | DM        | None (user-scoped DM reset)                                                                                            |
| `/reset`            | Server    | Administrator, server owner, or bot owner                                                                              |
| `/generate`         | Server/DM | Command enabled + image generation enabled                                                                             |
| `/dashboard`        | Server/DM | Command enabled                                                                                                        |
| `/vc-join`          | Server    | Command enabled + voice engine enabled + voice channel access. Live VC speaking requires `Ultra`                       |
| `/vc-leave`         | Server    | Command enabled + voice engine enabled. Disconnecting live VC still depends on the active voice session / `Ultra` path |
| `/ping`             | Server/DM | Command enabled                                                                                                        |

## Command behavior details

### `/activate-channel`

* Marks the current channel as AI-enabled.
* In AI-enabled channels, bot can reply without mentions.

### `/remove-channel`

* Removes the current channel from AI-enabled list.

### `/reset`

* In DM: clears DM conversation memory for that user context.
* In server: clears the current bot/server/channel conversation context, not
  every channel in the guild.

### `/generate`

* Generates an image from prompt.
* Optional reference image is supported.
* If image generation is disabled on the bot, command returns a disabled message.

### `/dashboard`

* Returns the dashboard URL.

### `/vc-join`

* Joins the requester's voice channel (or selected voice channel parameter).
* Fails if bot lacks voice permissions or voice runtime dependencies.
* Live VC speaking requires the `Ultra` plan.
* On lower tiers, the bot responds in personality that voice-channel speaking
  requires `Ultra`, that voice messages are still free, and that billing is at
  `https://verba.ink/billing`.

### Natural-language voice join

* Bots can also receive the same request from a normal mention message when the
  message is clearly asking them to join VC/call.
* This uses the same join rules as `/vc-join`; plan, permissions, and channel
  access still apply.

### `/vc-leave`

* Leaves current voice channel if connected.
* If there is no active voice session and the bot is not on `Ultra`, it returns
  the same in-character upgrade response instead.

### `/ping`

* Health/status check command with latency output.

## Command toggle behavior

When a command is disabled in dashboard:

* Invocation returns a disabled-command response.
* Command registration may take a short delay to reflect in Discord command picker.

Slash command toggles are separate from **Discord Expression Controls**. Turning
off a slash command does not disable reactions, GIFs, stickers, custom emojis,
polls, or multi-message Discord replies.

## Common command errors

<AccordionGroup>
  <Accordion title="This command is disabled for this bot">
    Re-enable the command in Discord module -> Slash Command Toggles.
  </Accordion>

  <Accordion title="You need Administrator permission">
    Server-only administrative commands require admin privileges in that guild.
  </Accordion>

  <Accordion title="This command can only be used in a server channel">
    Channel-management commands are server scoped and not available in DMs.
  </Accordion>

  <Accordion title="Image provider unavailable">
    Temporary upstream issue. Retry shortly or simplify prompt/reference image.
  </Accordion>

  <Accordion title="Voice runtime unavailable">
    Worker/runtime dependency issue. Restart worker and verify voice deps.
  </Accordion>
</AccordionGroup>

## Custom message templates

You can customize command/error text in the **Custom Messages** page.

Frequently used template variables:

* `{messagesPerMinute}`
* `{contextLabel}`
* `{channelMention}`
* `{verb}`
* `{user}`

<CardGroup cols={2}>
  <Card title="Discord Deployment" icon="message" href="/guides/discord">
    Setup guide for connection, intents, profiles, and server routing.
  </Card>

  <Card title="Discord Custom Builder" icon="wand-magic-sparkles" href="/guides/custom-builder">
    Build custom slash commands, buttons, events, timed automations, and webhooks.
  </Card>
</CardGroup>