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

# Commands & Permissions

> All the commands and permissions related to managing and using the ticket system.

# Commands & Permissions

> All the commands and permissions related to managing and using the ticket system.

## Permission Priority

When the system resolves who can act on a ticket, it checks in this order:

<Badge color="red">Administrator</Badge> → <Badge color="yellow">Manage Server</Badge> → <Badge color="green">Ticket Support</Badge>

That means:

* If someone has both a <Badge color="red">Administrator</Badge> role and a <Badge color="green">Ticket Support</Badge> role for a topic, they are treated as <Badge color="red">Administrator</Badge>.
* <Badge color="yellow">Manage Server</Badge> covers all global configuration — categories, logs, limits, support roles.
* <Badge color="green">Ticket Support</Badge> is granted via a topic support role, a global support role, being added as a ticket admin, or having Manage Channels.

## Commands

<Note>
  The primary command for the ticket system is `;ticket`. It also supports the alias `;t`.
</Note>

<Warning>
  Some commands require the `administrator` permission. If you don't want users to have access to server settings, use [Fake Permissions](/resources/permissions) to let specific roles use ticket management commands only.
</Warning>

### Configuration Commands

These commands configure the structure of the ticket system.

<AccordionGroup>
  <Accordion title="System Management" icon="gear">
    **These require one of:**

    * `manage_guild` permission

    | Command                                | Description                                            | Example                 |
    | -------------------------------------- | ------------------------------------------------------ | ----------------------- |
    | `;ticket setup`                        | Open the interactive setup wizard (enables the system) | `;ticket setup`         |
    | `;ticket send [#channel] [embed code]` | Send or resend the ticket panel                        | `;ticket send #support` |
    | `;ticket reset`                        | Disable the ticket system                              | `;ticket reset`         |
    | `;ticket config`                       | View the current ticket configuration                  | `;ticket config`        |
    | `;ticket limit (1–20)`                 | Set max open tickets per user                          | `;ticket limit 2`       |
  </Accordion>

  <Accordion title="Categories & Logs" icon="folder">
    **These require:**

    * `manage_guild` permission

    | Command                                        | Description                     | Example                                             |
    | ---------------------------------------------- | ------------------------------- | --------------------------------------------------- |
    | `;ticket settings global (category)`           | Set the default open category   | `;ticket settings global Open Tickets`              |
    | `;ticket settings closed (category)`           | Set the default closed category | `;ticket settings closed Closed Tickets`            |
    | `;ticket settings category (topic) (category)` | Set a per-topic open category   | `;ticket settings category support Support Tickets` |
    | `;ticket settings logs (#channel)`             | Set the transcript log channel  | `;ticket settings logs #ticket-logs`                |
  </Accordion>

  <Accordion title="Toggles & Timers" icon="sliders">
    **These require:**

    * `manage_guild` permission

    | Command                               | Description                        | Example                             |
    | ------------------------------------- | ---------------------------------- | ----------------------------------- |
    | `;ticket settings counting enable`    | Enable ticket counting             | `;ticket settings counting enable`  |
    | `;ticket settings counting disable`   | Disable ticket counting            | `;ticket settings counting disable` |
    | `;ticket settings claiming enable`    | Enable the claiming system         | `;ticket settings claiming enable`  |
    | `;ticket settings claiming disable`   | Disable the claiming system        | `;ticket settings claiming disable` |
    | `;ticket claiming public`             | Make claims visible to all support | `;ticket claiming public`           |
    | `;ticket claiming private`            | Hide claims from other support     | `;ticket claiming private`          |
    | `;ticket settings inactivity (hours)` | Auto-close after inactivity        | `;ticket settings inactivity 24`    |
  </Accordion>

  <Accordion title="Topics" icon="list">
    **These require:**

    * `administrator` permission

    | Command                                                 | Description                   | Example                                                        |
    | ------------------------------------------------------- | ----------------------------- | -------------------------------------------------------------- |
    | `;ticket topic add (name)`                              | Create a topic                | `;ticket topic add Support`                                    |
    | `;ticket topic remove (name)`                           | Delete a topic                | `;ticket topic remove Support`                                 |
    | `;ticket topics`                                        | List all topics               | `;ticket topics`                                               |
    | `;ticket topic name (old) (new)`                        | Rename a topic                | `;ticket topic name Support Help`                              |
    | `;ticket topic description (name) (text)`               | Set topic description         | `;ticket topic description support Get help from staff`        |
    | `;ticket topic emoji (name) (emoji)`                    | Set topic emoji               | `;ticket topic emoji support 🎫`                               |
    | `;ticket topic status (name) (open\|closed)`            | Enable or disable a topic     | `;ticket topic status support closed`                          |
    | `;ticket topic weight (name) (number)`                  | Set sort weight               | `;ticket topic weight support 10`                              |
    | `;ticket topic channelname (name) (pattern)`            | Set channel name template     | `;ticket topic channelname support ticket-{username}-{number}` |
    | `;ticket topic channeltopic (name) (text)`              | Set channel topic             | `;ticket topic channeltopic support Ticket for {user}`         |
    | `;ticket topic closed (name) (category)`                | Set per-topic closed category | `;ticket topic closed support Closed Tickets`                  |
    | `;ticket topic claimeffect (name) (none\|hide\|rename)` | Set claim effect              | `;ticket topic claimeffect support hide`                       |
    | `;ticket topic permissions (name) (close) (delete)`     | Set close/delete permissions  | `;ticket topic permissions support everyone admin`             |
    | `;ticket topic formanswers (name)`                      | Toggle showing form answers   | `;ticket topic formanswers support`                            |
    | `;ticket settings embed (topic) (code)`                 | Set opening embed for a topic | `;ticket settings embed support {embed}$v{title: Welcome}`     |
  </Accordion>

  <Accordion title="Forms" icon="list-check">
    **These require:**

    * `administrator` permission

    | Command                                                     | Description                             | Example                                                  |
    | ----------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------- |
    | `;ticket modal add (topic) (name) [description]`            | Add a form field                        | `;ticket modal add support Issue Describe your issue`    |
    | `;ticket modal remove (topic) (name)`                       | Remove a form field                     | `;ticket modal remove support Issue`                     |
    | `;ticket modal list`                                        | List all form fields                    | `;ticket modal list`                                     |
    | `;ticket modal name (topic) (old) (new)`                    | Rename a field                          | `;ticket modal name support Issue Problem`               |
    | `;ticket modal description (topic) (name) (text)`           | Edit placeholder text                   | `;ticket modal description support Issue What happened?` |
    | `;ticket modal type (topic) (name) (short_text\|long_text)` | Change the field type *(alias `style`)* | `;ticket modal type support Issue long_text`             |
    | `;ticket modal toggle (topic) (name)`                       | Enable or disable a field               | `;ticket modal toggle support Issue`                     |
  </Accordion>

  <Accordion title="Access Management" icon="shield-halved">
    **Global support roles require:**

    * `manage_guild` permission

    | Command                                       | Description                     | Example                                        |
    | --------------------------------------------- | ------------------------------- | ---------------------------------------------- |
    | `;ticket settings supportrole add (@role)`    | Add a global support role       | `;ticket settings supportrole add @Support`    |
    | `;ticket settings supportrole remove (@role)` | Remove a global support role    | `;ticket settings supportrole remove @Support` |
    | `;ticket support add (topic) (@role)`         | Add a per-topic support role    | `;ticket support add support @Helpers`         |
    | `;ticket support remove (topic) (@role)`      | Remove a per-topic support role | `;ticket support remove support @Helpers`      |
    | `;ticket support list`                        | List all support roles          | `;ticket support list`                         |

    **Ticket admins and per-topic admin roles require:**

    * `administrator` permission

    | Command                                      | Description                  | Example                                        |
    | -------------------------------------------- | ---------------------------- | ---------------------------------------------- |
    | `;ticket admin add (@user)`                  | Grant ticket admin to a user | `;ticket admin add @wanderer`                  |
    | `;ticket admin remove (@user)`               | Remove ticket admin          | `;ticket admin remove @wanderer`               |
    | `;ticket admins`                             | List ticket admins           | `;ticket admins`                               |
    | `;ticket topic admin add (topic) (@role)`    | Add per-topic admin role     | `;ticket topic admin add support @Managers`    |
    | `;ticket topic admin remove (topic) (@role)` | Remove per-topic admin role  | `;ticket topic admin remove support @Managers` |
    | `;ticket role set (@role)`                   | Set the ticket owner role    | `;ticket role set @Ticket Owner`               |
    | `;ticket role remove`                        | Remove the ticket owner role | `;ticket role remove`                          |
  </Accordion>

  <Accordion title="Blacklist" icon="ban">
    **These require:**

    * `manage_guild` permission

    | Command                              | Description                  | Example                                |
    | ------------------------------------ | ---------------------------- | -------------------------------------- |
    | `;ticket blacklist (@user) [reason]` | Blacklist a member           | `;ticket blacklist @wanderer spamming` |
    | `;ticket unblacklist (@user)`        | Remove from blacklist        | `;ticket unblacklist @wanderer`        |
    | `;ticket blacklisted`                | View all blacklisted members | `;ticket blacklisted`                  |
  </Accordion>
</AccordionGroup>

***

### Ticket Interaction Commands

Run inside an open ticket channel.

<AccordionGroup>
  <Accordion title="Claiming" icon="hand-holding">
    **These require:**

    * Claiming enabled on the server
    * The ticket is not already claimed
    * The ticket creator cannot claim their own ticket

    **And one of the following:**

    * <Badge color="red">Administrator</Badge> permission
    * A configured <Badge color="green">Ticket Support</Badge> role

    | Command           | Description                | Example           |
    | ----------------- | -------------------------- | ----------------- |
    | `;ticket claim`   | Claim the current ticket   | `;ticket claim`   |
    | `;ticket unclaim` | Remove the current claimer | `;ticket unclaim` |
  </Accordion>

  <Accordion title="Closing" icon="lock">
    **These require one of the following:**

    * The ticket creator (if `everyone` close permission is set on the topic)
    * The current claimer
    * <Badge color="red">Administrator</Badge> permission
    * A configured <Badge color="green">Ticket Support</Badge> role (when topic uses `support` permission)

    | Command                | Description                       | Example                |
    | ---------------------- | --------------------------------- | ---------------------- |
    | `;ticket close`        | Close the ticket                  | `;ticket close`        |
    | `;ticket closerequest` | Send a close confirmation request | `;ticket closerequest` |
  </Accordion>

  <Accordion title="Ticket Modification" icon="pen">
    **These require:**

    * <Badge color="green">Ticket Support</Badge> role, ticket admin, or Manage Channels

    | Command                    | Description                  | Example                         |
    | -------------------------- | ---------------------------- | ------------------------------- |
    | `;ticket rename (name)`    | Rename the ticket channel    | `;ticket rename billing-issue`  |
    | `;ticket move (topic)`     | Move ticket to another topic | `;ticket move billing`          |
    | `;ticket priority (level)` | Set ticket priority          | `;ticket priority urgent`       |
    | `;ticket remind [message]` | Remind the ticket owner      | `;ticket remind Please respond` |
  </Accordion>

  <Accordion title="Member Access" icon="users">
    **These require:**

    * <Badge color="green">Ticket Support</Badge> role, ticket admin, or Manage Channels

    | Command                            | Description                             | Example                     |
    | ---------------------------------- | --------------------------------------- | --------------------------- |
    | `;ticket allow (@user or @role)`   | Add a member or role to the ticket      | `;ticket allow @wanderer`   |
    | `;ticket unallow (@user or @role)` | Remove a member or role from the ticket | `;ticket unallow @wanderer` |
  </Accordion>
</AccordionGroup>

***

### Utilities

No special permission required.

| Command                | Description                           |
| ---------------------- | ------------------------------------- |
| `;ticket config`       | View the current ticket configuration |
| `;ticket topics`       | List all configured topics            |
| `;ticket leaderboard`  | Top ticket openers in the server      |
| `;ticket info (@user)` | View all tickets from a user          |
