> ## 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.

# Support Tickets with Private Channels and Transcripts

> Create button panels that open private support channels for members — with HTML transcripts, staff roles, per-button categories, and ticket bans.

Tickets give your members a clean way to reach your staff privately. A panel of buttons in any channel lets someone open a dedicated support channel that only they, your support roles, and the bot can see. When the conversation is over, you can save a full HTML transcript before closing, and every step of the ticket's life can be logged automatically.

## Set Up Tickets

<Steps>
  <Step title="Create a panel">
    Go to **Dashboard → Tickets** and create a panel: pick the channel it gets posted in, the category that new ticket channels go under, and the roles that handle them. Add a button and save — the panel appears within a few seconds.

    From Discord, run `/ticketpanel create` to make the panel, then `/ticketpanel addoption` to add a button to it.
  </Step>

  <Step title="Set a transcript channel">
    Run `/ticket settings` or configure it on the dashboard. Without a transcript channel, deleting a ticket permanently deletes the conversation with it — there is no way to recover it.
  </Step>

  <Step title="Check bot permissions">
    Make sure the bot has the **Manage Channels** permission. It needs this to create and remove ticket channels.
  </Step>
</Steps>

## How Tickets Work

When a member clicks a button, they answer the optional question you set — then a private channel opens that only they, your support roles, and the bot can see. Everyone involved receives a private link to it; no one else sees a thing.

Each button can have its own question and send its tickets to its own category, so a "Support" button and a "Report" button don't have to land in the same place.

**Staff can:**

* **Claim** the ticket as theirs to handle
* **Add or remove** people from the channel
* **Rename** the channel
* **Close** the ticket, making it read-only for the opener
* **Reopen** a closed ticket, restoring the opener's access
* **Delete** the ticket — when a transcript channel is set, a full HTML transcript is saved before deletion

Transcripts are HTML files that render to look like the Discord channel itself. Keep the transcript channel staff-only.

<Note>
  By default each member can have **1 open ticket at a time**. You can raise this up to **5** using `/ticket settings`. Every action — opened, claimed, closed, reopened, renamed, deleted — can be logged to a channel of your choice.
</Note>

***

## Panel Commands

| Command | What it does | Who can use it |
| - | - | - |
| `/ticketpanel create <channel> <title> [description] [category] [support_role]` | Create a new ticket panel. | Manage Server |
| `/ticketpanel addoption <panel> <label> [emoji] [category] [question]` | Add a button to the panel. | Manage Server |
| `/ticketpanel removeoption <panel> <label>` | Remove a button from the panel. | Manage Server |
| `/ticketpanel addrole <panel> <role>` | Add a support role to the panel. | Manage Server |
| `/ticketpanel removerole <panel> <role>` | Remove a support role from the panel. | Manage Server |
| `/ticketpanel list` | List all panels, their buttons, and any errors. | Manage Server |
| `/ticketpanel delete <panel>` | Remove the panel and its message. Open tickets stay open. | Manage Server |
| `/ticket settings [transcript_channel] [log_channel] [max_open]` | Configure where transcripts and logs go, and the open ticket limit. | Manage Server |

## In-Ticket Commands

| Command | What it does | Who can use it |
| - | - | - |
| `/ticket close` | Close the ticket you're in. | Staff or the person who opened it |
| `/ticket claim` | Take the ticket as yours to handle. | Ticket staff |
| `/ticket add <user>` | Give someone access to the ticket. | Ticket staff |
| `/ticket remove <user>` | Remove someone's access. | Ticket staff |
| `/ticket rename <name>` | Rename the ticket channel. | Ticket staff |
| `/ticket transcript` | Save the conversation as an HTML file right now. | Ticket staff |

## Ticket Bans

Ticket bans prevent a member from opening new tickets. Their existing open tickets stay open so any ongoing conversations aren't cut off.

| Command | What it does | Who can use it |
| - | - | - |
| `/ticketban <user> [reason]` | Stop someone from opening new tickets. | Ticket staff |
| `/ticketunban <user>` | Allow them to open tickets again. | Ticket staff |