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

# Tickets

> A panel of buttons that opens private support channels.

## <Icon icon="gauge" size={24} /> Make a panel on the dashboard

<Steps>
  <Step title="Open Support Tickets">
    On the [dashboard](https://newt.bot/servers), pick your server and open **Support Tickets**.
  </Step>

  <Step title="Use the ready-made panel">
    It comes with three buttons: **Get help**, **Report someone** and **Appeal a punishment**.
  </Step>

  <Step title="Pick where it goes and who handles it">
    Choose a channel under **Post it in**, or let Newt make a new #tickets channel. Pick the staff role under **Who handles tickets**.
  </Step>

  <Step title="Click Add to server">
    Or click **Customize first** to change the text and buttons. The panel posts within a few seconds.
  </Step>
</Steps>

<Tip>
  Set a **transcript channel** in the settings. Without one, deleting a ticket deletes the conversation.
</Tip>

## <Icon icon="terminal" size={24} /> Or use commands

<CodeGroup>
  ```plaintext Syntax theme={null}
  /ticketpanel create <channel> <title> [description] [category] [support_role]
  /ticketpanel addoption <panel> <label> [emoji] [category] [question]
  ```

  ```plaintext Example theme={null}
  /ticketpanel create channel:#support title:Need help? support_role:@Staff
  /ticketpanel addoption panel:Need help? label:Report emoji:🚩 question:Who are you reporting?
  ```
</CodeGroup>

Each button can ask its own question before the ticket opens, and send its tickets to its own category.

## <Icon icon="gear" size={24} /> Ticket settings

```plaintext theme={null}
/ticket settings [transcript_channel] [log_channel] [max_open]
```

* **transcript\_channel:** where transcripts are saved as HTML files. Keep it staff-only.
* **log\_channel:** one line per open, claim, close, reopen, rename and delete.
* **max\_open:** tickets one person can have open at once. 1 by default, up to 5.
* **Auto-close** (dashboard only): after a set number of quiet days Newt asks if the ticket is still needed, then closes it 48 hours later unless someone replies.

## <Icon icon="headset" size={24} /> Working a ticket

Run these inside the ticket channel. Most are also buttons in the ticket.

<AccordionGroup>
  <Accordion title="Claim" icon="hand">
    ```plaintext theme={null}
    /ticket claim
    ```
  </Accordion>

  <Accordion title="Add or remove someone" icon="user-plus">
    ```plaintext theme={null}
    /ticket add <user>
    /ticket remove <user>
    ```
  </Accordion>

  <Accordion title="Rename the channel" icon="pen">
    ```plaintext theme={null}
    /ticket rename <name>
    ```
  </Accordion>

  <Accordion title="Save a transcript" icon="file-lines">
    ```plaintext theme={null}
    /ticket transcript
    ```
  </Accordion>

  <Accordion title="Close" icon="lock">
    The member can read but not talk. **Reopen** gives their voice back. **Delete** saves a transcript first, if a transcript channel is set.

    ```plaintext theme={null}
    /ticket close
    ```
  </Accordion>

  <Accordion title="Ban someone from tickets" icon="ban">
    Their open tickets stay open.

    ```plaintext theme={null}
    /ticketban <user> [reason]
    /ticketunban <user>
    ```
  </Accordion>
</AccordionGroup>

## <Icon icon="pen-to-square" size={24} /> Manage panels

<AccordionGroup>
  <Accordion title="Remove a button" icon="minus">
    ```plaintext theme={null}
    /ticketpanel removeoption <panel> <label>
    ```
  </Accordion>

  <Accordion title="Add or remove a staff role" icon="users">
    ```plaintext theme={null}
    /ticketpanel addrole <panel> <role>
    /ticketpanel removerole <panel> <role>
    ```
  </Accordion>

  <Accordion title="See every panel" icon="list">
    ```plaintext theme={null}
    /ticketpanel list
    ```
  </Accordion>

  <Accordion title="Delete a panel" icon="trash">
    Deletes its message. Open tickets stay open.

    ```plaintext theme={null}
    /ticketpanel delete <panel>
    ```
  </Accordion>
</AccordionGroup>

## <Icon icon="circle-info" size={24} /> Good to know

* Newt needs **Manage Channels** to create and delete ticket channels.
* Up to 5 buttons per panel.
* Up to 5 panels, or 15 with [Premium](/help/premium).
* Buttons keep working after restarts and updates.

**Permission:** Panels and `/ticket settings` need Manage Server. Working a ticket needs a staff role on that panel. The person who opened a ticket can also close it.