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

# Setting Up the Haze Ticket System in Your Server

> Run one command to create a ticket category, transcripts channel, and panel, then configure staff roles, ping settings, and inactivity limits.

Getting tickets running takes a single command and a couple of role assignments. Once the basics are in place you can tune limits, inactivity timeouts, and panel placement to match your server's workflow.

## Initial Setup

<Steps>
  ### Run the setup command

  In the channel where you want the ticket panel to appear, run:

  ```bash theme={null}
  ,ticket setup
  ```

  Haze creates a private **Tickets** category, a **#transcripts** channel for staff only, and a panel message with a default **Open ticket** button — all in one go.

  ### Add a staff role

  Grant a role the ability to view, claim, and close tickets:

  ```bash theme={null}
  ,ticket staff @Moderators
  ```

  Run the command again with the same role to remove it. You can add as many staff roles as you need.

  ### (Optional) Add a support ping role

  If you want a specific role mentioned whenever a new ticket opens, set a support role separately from your staff role:

  ```bash theme={null}
  ,ticket support @Support
  ,ticket ping on
  ```

  The support role is pinged in the new ticket channel. Toggle pings off at any time with `,ticket ping off`.

  ### Set ticket limits and inactivity

  Cap the number of tickets a single member can have open at once, and optionally enable auto-close for idle tickets:

  ```bash theme={null}
  ,ticket limit 25
  ,ticket inactivity 60
  ```

  <Note>
    The minimum inactivity value is **30 minutes**. Set it to `0` to disable auto-close entirely.
  </Note>
</Steps>

## Panel Placement

If you want the ticket panel on an existing bot message rather than a new one, pass the message link or ID:

```bash theme={null}
,ticket panel <message link or id>
```

After changing button settings or the panel title and description, rebuild the buttons on the panel to apply your changes:

```bash theme={null}
,ticket refresh
```

## Limits & Inactivity

Use these commands any time to adjust thresholds without re-running setup:

```bash theme={null}
,ticket limit 25        # maximum open tickets per member (0–200)
,ticket inactivity 60   # auto-close after 60 minutes of inactivity
```

<Note>
  Inactivity auto-close requires a minimum of **30 minutes**. Setting the value to `0` turns it off so tickets stay open indefinitely until manually closed.
</Note>