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

# Tickets

> Build support panels, forms, staff workflows, and transcripts.

## Create a panel

Use the dashboard Tickets page or the Discord editor. A panel has buttons or a dropdown; its options describe why a member wants to open a ticket.

```text theme={null}
,ticket configure
,ticket list
```

## Publish and route

Choose a publish channel, an open-ticket category, and support roles. Dashboard posts are processed by the bot and can update an existing message.

<Info>
  Tickets are private text channels with member and staff permission overwrites. Configure the category and roles before publishing a usable panel.
</Info>

```text theme={null}
,ticket send support #support
```

## Forms and access

Reusable dashboard forms support up to five short or long text questions, required answers, placeholders, and length limits. Attach a form to a panel option. Member and role blacklist entries prevent opening tickets.

## Staff workflow

Claim tickets, add or remove participants, close or reopen channels, and generate transcripts. Saved replies can be sent from the dashboard or with ticket reply.

```text theme={null}
,ticket claim
,ticket reply billing-help
,ticket close Resolved
```

## Lifecycle settings

Configure per-member limits, pinned controls, claiming, channel names and padding, overflow and closed categories, deletion delays, and event logs. Zero seconds in the dashboard retains a closed channel. Activity history begins after event tracking is deployed.

## Ticket variables

Use these variables in ticket panel messages, greetings, and other ticket templates. The bot fills them in when it sends the message.

### Guild

| Variable | Description |
| - | - |
| `{guild}` | Server name |
| `{guild.name}` | Server name |
| `{guild.id}` | Server ID |
| `{guild.icon}` | Server icon URL |

### Channel

| Variable | Description |
| - | - |
| `{channel}` | Channel mention |
| `{channel.id}` | Channel ID |
| `{channel.name}` | Channel name |

### Ticket

| Variable | Description |
| - | - |
| `{ticket.id}` | Ticket ID |
| `{ticket.number}` | Ticket number |
| `{ticket.channel}` | Ticket channel mention |
| `{ticket.author}` | Ticket creator |
| `{ticket.author.mention}` | Ticket creator mention |
| `{ticket.author.id}` | Ticket creator ID |
| `{ticket.option}` | Selected ticket option |
| `{ticket.option.label}` | Selected ticket option label |
| `{ticket.option.key}` | Selected ticket option key |
| `{ticket.claimer}` | User currently claiming the ticket |
| `{ticket.claimer.mention}` | Claimer mention |

### Panel

| Variable | Description |
| - | - |
| `{panel.id}` | Panel ID |
| `{panel.name}` | Panel name |

### Form Variables

Every form question automatically creates a variable. A question with the variable name `reason` is available as `{form.reason}`. Use `{form.<variable_name>}` for any answer, replacing `<variable_name>` with the configured question key.

| Variable | Description |
| - | - |
| `{form.reason}` | User’s reason for opening the ticket |
| `{form.email}` | Email field |
| `{form.username}` | Username field |
| `{form.discord}` | Discord field |
| `{form.version}` | Version field |
| `{form.additional}` | Additional information |
| `{form.<variable_name>}` | Any form answer — replace `<variable_name>` with the question’s variable name |
| `{form.issue}` | Answer for a question with the variable name issue |
| `{form.steps_to_reproduce}` | Answer for a question with the variable name steps\_to\_reproduce |
| `{form.anything_else}` | Answer for a question with the variable name anything\_else |

For example, the question keys `issue`, `steps_to_reproduce`, and `anything_else` become `{form.issue}`, `{form.steps_to_reproduce}`, and `{form.anything_else}` in your template.

## Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord's slash menu.

<AccordionGroup>
  <Accordion title=",ticket" icon="terminal">
    Configure and manage tickets.

    Aliases: `,tickets`, `,tix`.

    <Note>This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.</Note>

    ### ticket configure

    Open the interactive ticket editor.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket configure
    ```

    ### ticket send

    Send a saved panel.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket send <panel> [channel]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `panel` | Yes | Panel name or ID |
    | `channel` | No | Channel override |

    ### ticket list

    List ticket panels.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket list
    ```

    ### ticket add

    Add a user to this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket add <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | User |

    ### ticket remove

    Remove a user from this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket remove <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | User |

    ### ticket claim

    Claim this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket claim
    ```

    ### ticket close

    Close this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket close [reason]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `reason` | No | Reason |

    ### ticket reopen

    Reopen this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket reopen
    ```

    ### ticket delete

    Delete this ticket channel.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket delete
    ```

    ### ticket transcript

    Generate a transcript.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket transcript
    ```

    ### ticket reply

    Send a saved reply in this ticket.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket reply <name>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `name` | Yes | Saved reply name |

    ### ticket info

    View ticket information.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket info
    ```
  </Accordion>

  <Accordion title=",ticket-create" icon="terminal">
    Open the live ticket-panel editor.

    Aliases: `,ticketpanel`, `,tickets-create`.

    <Note>This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.</Note>

    ### ticket-create

    Open the live ticket-panel editor.

    ```text Prefix syntax theme={null} theme={null}
    ,ticket-create
    ```
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.