Categories¶
Options¶
Name¶
Required
This will be visible to users on panels buttons/select menus, the questions modal (if enabled), in transcripts, in the Portal, etc. The name should be short and descriptive. Good examples include:
Support
General
Billing
Bug reports
Complaints
Applications
Reports
Channel name¶
Required ·
Default: ticket-{num}
The name of the ticket channel.
Available placeholders¶
{num}
/{number}
{name}
/{username}
Claiming¶
Default: false
When enabled, staff members will be able to use /claim
and /release
(and the button if enabled) for tickets in this category.
Claiming removes all other staff (except administrators) from the channel and may be useful if there is high demand for support in your server.
Cooldown¶
The amount of time members must wait (from creating a ticket) before opening another ticket in this category.
Must be an ms-parsable format (15m
, 1h
, 1 day
, etc).
Description¶
Required
A short (<100 characters) description to help members understand what the category is for. This will be shown on panel select menus.
Discord category¶
Default: Create a new category
Ticket channels will be created under this Discord category. The default option when creating a new ticket category is to create a new Discord category with the ticket category's name.
Emoji¶
Required
A Unicode emoji name/glyph or Discord custom emoji ID. This is used on buttons and select menus when creating a ticket.
If you enter the name of a Unicode emoji (e.g. ticket
or :ticket:
), the glyph should appear:
If you want to use a custom emoji, enter the numeric ID, which you can find by prepending the emoji name with \
(e.g. \:earth:
which will become <:earth:999437703730958388>
).
Emojis will be animated if an animated version is available.
Example of valid inputs:
:question:
→question
→❓
999437703730958388
(a custom emoji ID).
Warning
The conversion from names to glyphs is not perfect/identical to Discord's.
For example, if you enter :pleading:
the glyph will appear suggesting that the name is valid,
but Discord calls :pleading_face:
.
Attempting to create a panel whilst a category has an invalid emoji will result in an error.
For this reason, it is safer to use the glyph (🥺
) rather than the name.
Feedback¶
Default: false
When enabled, the ticket creator will be prompted to give feedback on the support they received when they either make a close request or accept one.
Image¶
The URL of an image to add to the opening message embed.
Member limit¶
Default: 1
The maximum number of tickets a member can have open in this category at once.
Opening message¶
Required
Text that will be part of the ticket opening message. Use this to provide and ask for information, such as stating what is expected of the member (e.g. don't ping staff) and what information they need to provide.
Available placeholders¶
{name}
/{username}
(the creator){avgResponseTime}
(for this category only){avgResolutionTime}
(for this category only)
Ping roles¶
The selected roles will be pinged (in the opening message) when a ticket is created.
Slow mode¶
Default: Off
This option enables Discord's slow mode in ticket channels with the selected cooldown.
Required roles¶
Members will not be able to create tickets in this category unless they have the required roles.
The current behaviour is that members must have all of the selected roles, so in most cases you will want to select only one role.
Require topic¶
Default: Off
When enabled, members will be prompted to enter a topic through a modal form when creating a ticket.
This can be edited later using the /topic
command or the Edit button on the opening message.
Note that topic and questions are mutually exclusive and this option is ignored if questions are present.
Staff roles¶
Required
The selected roles will be added to ticket channels when they are created.
Tip
This is a native multi-select element and usage varies between browsers and operating systems. On Windows, you can select multiple and deselect options with Ctrl+Left Button, and hold Shift to select a range. For more information, refer to MDN's usage notes.
Total limit¶
Default: 50
This limits the total number of tickets (between all members) that can be open in this category at once. The default value, 50, is the maximum number of channels that can be under a Discord category.
You may want to lower this limit so your staff team doesn't get overwhelmed. For example, it would be a good idea to set this to 5 or 10 for a reports category, so you don't get 30 identical reports at once.