> For the complete documentation index, see [llms.txt](https://docs.homebots.live/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.homebots.live/modules/tickets.md).

# Tickets

Not a fan of ModMail, and/or want to use more traditional tickets? This module allows just for that! You can create as many single- or multi-category ticket panels as your heart desires.

***

### Config Ticket Module (`/config ticket module`)

{% hint style="warning" %}
By default, only members with the **Administration** permission can use this command.
{% endhint %}

*Configure the Tickets module.*

**`transcript_channel`**: The channel where all ticket transcripts will be sent.

***

### Create Single-category Ticket Panel (`/config ticket create_single`)

{% hint style="warning" %}
By default, only members with the **Administration** permission can use this command. Additionally, the Ticket module must first be configured before using this command.
{% endhint %}

*Create a single-category ticket panel.*

**`category`**: The category that all tickets from this panel will be created in.

**`mentions_role`**: The role that will be mentioned when a ticket from this panel is created.

**`admin_role`**: This panel's admin role which can delete tickets.

**`panel_name`**: The name of this ticket panel message.

**`description`**: The description of this ticket panel message.

**`author_icon`**: The image to be used as this panel message's author icon.

**`thumbnail`**: The image to be used as this panel message's thumbnail.

**`image`**: The image to be set for this panel message.

**`footer`**: The footer text to be used in this panel message.

**`footer_icon`**: The image to be used as this panel message's footer icon.

**`button_text`**: The text to be used in this panel's ticket creation button.

**`button_emoji`**: The emoji to be used in this panel's ticket creation button.

{% hint style="info" %}

### **Character Limits**

**`panel_name`**: maximum of 256 characters

**`description`**: maximum of 4096 characters

**`footer`**: maximum of 500 characters

**`button_text`**: maximum of 100 characters
{% endhint %}

***

### Create Multi-category Ticket Panel (`/config ticket create_multi`)

{% hint style="warning" %}
By default, only members with the **Administration** permission can use this command. Additionally, the Ticket module must first be configured before using this command.
{% endhint %}

*Create a multi-category ticket panel.*

**`mentions_role`**: The role that will be mentioned when a ticket from this panel is created.

**`admin_role`**: This panel's admin role which can delete tickets.

**`panel_name`**: The name of this ticket panel message.

**`description`**: The description of this ticket panel message.

**`author_icon`**: The image to be used as this panel message's author icon.

**`thumbnail`**: The image to be used as this panel message's thumbnail.

**`image`**: The image to be set for this panel message.

**`footer`**: The footer text to be used in this panel message.

**`footer_icon`**: The image to be used as this panel message's footer icon.

{% hint style="info" %}

### **Character Limits**

**`panel_name`**: maximum of 256 characters

**`description`**: maximum of 4096 characters

**`footer`**: maximum of 500 characters
{% endhint %}

***

### Ticket Add (`/ticket add`)

{% hint style="warning" %}
By default, only members with the **Administration** permission can use this command. Additionally, the Ticket module must first be configured before using this command.
{% endhint %}

*Add a member or role to a ticket.*

**`target`**: The member or role to be added to this ticket.

***

### Ticket Remove (`/ticket remove`)

{% hint style="warning" %}
By default, only members with the **Administration** permission can use this command. Additionally, the Ticket module must first be configured before using this command.
{% endhint %}

*Remove a member or role from a ticket.*

**`target`**: The member or role to be removed from this ticket.