Forms
Add intake questions to topics so members fill in details before a ticket opens.
Form Rules
Topic-Level
Forms are configured per topic. Each topic has its own independent set of fields.
One per Topic
A topic can have at most 5 fields. Fields can be individually toggled off without deleting them.
Answer Snapshots
Form answers submitted by the member are saved to the ticket record. Old tickets keep the exact answers from the time they were opened.
Modal Popup
When a topic has active fields, a popup appears before the ticket channel is created. The member must submit it to proceed.
Form Limits
Due to Discord’s constraints, the following limits apply:- Up to
5fields per topic. - Each field label has a max length of
45characters. - Each text answer can be up to
1024characters. - All fields render inside the popup modal that appears when the topic is selected.
Adding Fields
1
Add a field to a topic
description sets the placeholder hint shown inside the input box.2
Set the field type
short_text. See Field Types for the difference.3
Verify the form
Managing Fields
Rename a field
Rename a field
Edit placeholder text
Edit placeholder text
Toggle a field on or off
Toggle a field on or off
Remove a field
Remove a field
Field Types
Inline modal fields (;ticket modal) are text-only — short_text and long_text. The richer field types below belong to reusable forms (see Reusable forms) and are set with:
short_text — single-line input
short_text — single-line input
A single-line text box. Best for short answers like order numbers, usernames, or brief descriptions.
long_text — multi-line input
long_text — multi-line input
A multi-line paragraph box. Best for longer explanations or issue descriptions.
checkbox — yes/no toggle
checkbox — yes/no toggle
A single checkbox the member can tick. The answer is recorded as yes/no.
select — dropdown choice
select — dropdown choice
A dropdown of preset options. Acts like radio buttons — the member picks one. Provide the options when configuring the field.
role_select — role picker
role_select — role picker
The member selects a server role. The chosen role is saved with the ticket.
user_select — member picker
user_select — member picker
The member selects a server member.
channel_select — channel picker
channel_select — channel picker
The member selects a channel.
checkbox_group — multi-select checkboxes
checkbox_group — multi-select checkboxes
A group of checkboxes where the member can tick several options. Set the choices on the dashboard — created from the command alone it starts with a placeholder option.
file_upload — file attachment
file_upload — file attachment
The member uploads one or more files as part of the form.
select and checkbox_group choices are set on the dashboard. Every other type works fully from the command.Reusable forms
Reusable forms are built once and attached to any number of topics — and they support every field type above, unlike inline modal fields.1
Create a form
2
Add fields
type is one of the field types above (defaults to short_text); required accepts yes/no.3
Attach it to a topic
;ticket forms detach (topic).;ticket forms list, ;ticket forms fields (form), ;ticket forms field remove (form) (key), ;ticket forms rename, ;ticket forms title, and ;ticket forms filtering.