Introducing Forms V2

What changed

The Send a Form block used to ask for typed answers only. With Forms V2, one Discord form can mix 11 field types, so members can pick a role, choose a member, tick a box or attach a screenshot instead of typing IDs and links. Your existing forms keep working unchanged.

The 11 field types

• Text Input: a short or long text answer.
• Dropdown: pick one or more of up to 25 options you define.
• User Select, Role Select and Channel Select: pick members, roles or channels from the server.
• Mentionable Select: pick users or roles.
• File Upload: upload up to 10 files in one field.
• Checkbox: a single yes or no tick box.
• Multiple Choice: tick boxes for up to 10 choices, with Maximum Selections setting how many can be ticked.
• Single Choice: pick exactly one of 2 to 10 choices.
• Header Text: text shown in the form to explain it. It is not a question.

Build a form

1. Add a Send a Form block to a command and give it a Form Name, such as apply.
2. Click Open Form Builder and fill in the Form Title.
3. Click + Add Field and pick a field type.
4. Give the field a label. Its Variable Name fills in from the label, and you can change it.
5. Check the preview, shown at Discord's real form size, then click Done.

On a phone, the Form Builder switches between Configure and Preview tabs.

Use the answers

Every answer comes back as a variable made from the form name and the field's variable name, such as {apply.team}. Pickers, choices and uploads add extra details you can use in any block after the form. The Form Builder lists every variable a field makes, and you can click one to copy it.

Good to know

• A Discord form shows up to 5 fields, and Header Text counts as one of them.
• A form can only open if it is the first reply. Put the Send a Form block before any block that replies, such as Send or Edit a Message set to reply.
• Uploads follow the server's normal file size limit. Discord's file links expire after about a day, so send the files as an attachment if you need to keep them.
• Set a field's Hidden setting to true, or a variable that resolves to true, to leave it out of the form.
• Forms you built before keep working exactly as they did. Their text fields open as Text Input fields with the same settings.