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

# Ticket Setup

<Warning>
  You’ll need the <code>manage\_guild</code> permission
</Warning>

***

## What You’ll Get

Setting up the ticket system will automatically create:

* **Tickets** category
* **#tickets** channel (your ticket panel)
* **#ticket-logs** channel (for transcripts & logs)
* **Create a Ticket** button

<Note>
  Give the bot these permissions:
  **Manage Channels**, **Send Messages**, **Embed Links**, **Attach Files**, and **Read Message History**.
</Note>

***

<Steps>
  <Step title="Step 1: Run Setup">
    ```bash theme={null}
    ;ticket setup
    ```

    quick setup for you! (you can ofc manage it anytime)
  </Step>

  <Step title="Step 2: Open the Config Panel">
    customize ticket configuration

    ```bash theme={null}
    ;ticket config
    ```

    You’ll see a **Ticket Configuration** panel:

    * Edit the **Panel Message** (what shows in #tickets)
    * Set a **Log Channel**
    * Add **Staff Roles**
    * Add or Remove **Panel Buttons**

    <Note>
      This panel auto saves for your guild (no need to setup again)
    </Note>
  </Step>

  <Step title="Step 3: Add Staff Roles">
    Press **Add Staff Role** and paste the **Role ID** of your support or moderation roles.
    Staff will gain access to tickets and can **Claim** or **Close** tickets.
  </Step>

  <Step title="Step 4: Customize Your Panel Message (Optional)">
    Want a more personal message? Click **Set Panel Message** and paste your custom embed raw [embed builder](https://xvz.wtf/embed-builder)
    Example:

    ```text theme={null}
    {title:ticket support$description:Wait for staff to help you!$#&color:#000000}
    ```
  </Step>

  <Step title="Step 5: Add More Buttons (Optional)">
    You can have up to **5** buttons for different ticket types
    Examples:

    ```bash theme={null}
    ;ticket button add support, primary 🎫
    ;ticket button add report bug, danger ⚠️
    ```

    Want to remove a button?

    ```bash theme={null}
    ;ticket button remove 1
    ```

    *(Use `;ticket config` to view button index)*
  </Step>

  <Step title="Step 6: Set the Message Inside New Tickets">
    You can control what message appears inside each new ticket channel.

    * Global ticket message:
      ```bash theme={null}
      ;ticket config message {title:ticket support$description:Wait for staff to help you!$#&color:#000000}
      ```
    * Button-specific ticket message:
      ```bash theme={null}
      ;ticket config message 1 {title:ticket support$description:Wait for staff to help you!$#&color:#000000}
      ```
  </Step>
</Steps>

**Example Embed:**

* Guide to add/remove ticket buttons

```plaintext theme={null}
;ticket button add create a ticket here, secondary 🎫
;ticket button remove 1
```

***

## recommended (For Staff)

* **Claim:** Marks the ticket as claimed by a staff and logs it in **#ticket-logs**
* **Close:** Close tickets

***

## Reset ticket configs

If you ever want to start fresh:

```bash theme={null}
;ticket reset
```

## ⚠️ Troubleshooting

<Note>
  **Can’t see ticket channels?** Only the ticket owner, staff can view them, Add your support role again with `;ticket config` → **Add Staff Role**
  You can use our `;roleinfo <role>` to get the role id
</Note>

***

<Note>
  If tickets buttons returns you <code>This interaction failed</code> Then you need to edit the buttons, modals, or embeds just a tiny (this is just a problem after hard restart resolved soon)
</Note>

***

<Note>
  **Panel didn’t update?** Run `;ticket config`, press **Remove all buttons**, then re‑add them Or paste a new Panel Message [embed builder](https://xvz.wtf/embed-builder)
</Note>

***

<Note>
  You can use our [embed builder](https://xvz.wtf/embed-builder) to make your panel message look professional with titles, thumbnails, and colors
</Note>

> To enable modals for ticket buttons you can use ;ticket config modal

<Note>
  This requires atleast 1 button added already
</Note>

# buttons styles:

* primary (blue)
* secondary (gray)
* success (green)
* danger (red)
* link (not recommended to use because it will not create tickets)

***

> requirement

* discord login
* discord user pfp (data we collect: avatar, banner, email, guilds)

<Note>
  You can manage this system with our [dashboard](https://xvz.wtf/dashboard)
</Note>