Command Reference
Every Forms command, from creating a form and adding questions to publishing a panel and reviewing submissions.
Command reference
All commands use the f!forms prefix; f!form is also an alias. Form names can be used in place of IDs.
Permissions
Setup and management commands require Manage Guild. Review commands require a reviewer role or Manage Guild. Members can use the panel and submit forms without either permission.
Setup and management
| Command | What it does |
|---|---|
| f!forms | Show the command overview. |
| f!forms setup [form] | Open Form Menu. Without a form, show a paginated picker or open the only form. |
| f!forms create <name> | Create a draft form and open it in Form Menu. |
| f!forms edit <form> | Open Form Menu for an existing form. |
| f!forms edit <form> <field>:<value> | Quick-edit one field: name, description, color, image, emoji, cooldown, multiple, ping, dm, or anonymous. |
| f!forms description <form> [text] | Set the form description. Omit the text to clear it. |
| f!forms list | List all forms in the community, with pagination. |
| f!forms view <form> | Show the form summary and question list. |
| f!forms delete <form> confirm | Permanently delete the form, its panel, and its submissions. |
Questions
| Command | What it does |
|---|---|
| f!forms question add <form> | Open the question-type picker. |
| f!forms question add <form> <type> | <prompt> | Add a required question. Type is text, paragraph, or choice. |
| f!forms question add <form> choice | <prompt> | <option> | <option> | Add a multiple-choice question with at least two options and up to ten. |
| f!forms question remove <form> <number> | Remove a question by its 1-based number. |
| f!forms question move <form> <number> <new number> | Move a question to another position. |
Choice options use the
| separator. Questions created through the command are required; use Form Menu to make one optional.Question examples
f!forms question add StaffApp text | Why do you want to join?
f!forms question add StaffApp choice | Availability | Weekdays | Weekends | BothAccess, appearance, and behavior
| Command | What it does |
|---|---|
| f!forms channel <form> <#channel|clear> | Set or clear the channel where the panel is published. |
| f!forms review <form> <#channel|clear> | Set or clear the channel where submissions are reviewed. |
| f!forms reviewer <form> <@role|clear> | Add a reviewer role. Clear removes all reviewer roles. |
| f!forms require <form> <@role|clear> | Add a role required to start the form. Clear removes all required roles. |
| f!forms emoji <form> [emoji] | Set the panel reaction. Omit the emoji to choose from a reaction picker. |
| f!forms color <form> <#hex> | Set the panel accent color. |
| f!forms image <form> <url|clear> | Set or clear the panel image. |
| f!forms cooldown <form> [duration] | Set the per-member cooldown. Omit the duration to show the current value. |
| f!forms multiple <form> <yes|no> | Allow more than one pending submission. |
| f!forms ping <form> <yes|no> | Ping reviewer roles when a new review is posted. |
| f!forms dm <form> <yes|no> | DM applicants when a submission is accepted or declined. |
| f!forms anonymous <form> <yes|no> | Hide the applicant name in review embeds. |
| f!forms max <form> <number|unlimited> | Set the per-member accepted-submission limit. 0 means unlimited. |
Cooldowns must be between one hour and thirty days. The accepted-submission limit accepts values from 0 to 1000. reviewer and require add one role per command; use clear to remove all roles from that field.
Messages
| Command | What it does |
|---|---|
| f!forms message <form> intro <text|reset> | Set the message members see when they start the form. |
| f!forms message <form> confirmation <text|reset> | Set the message shown after a submission is sent. |
| f!forms message <form> accept <text|reset> | Set the acceptance DM template. |
| f!forms message <form> decline <text|reset> | Set the decline DM template. |
Templates support {form}, {user}, and {reason}.
Preview, open, and publish
| Command | What it does |
|---|---|
| f!forms preview <form> | Preview the panel embed before publishing it. |
| f!forms open <form> | Open the form. Requires at least one question and both channels. |
| f!forms panel <form> [channel] | Publish the reaction panel. Re-running refreshes the existing panel. |
| f!forms close <form> | Stop new submissions while allowing pending reviews to finish. |
Publish checklist
f!forms preview StaffApp
f!forms open StaffApp
f!forms panel StaffAppReviewing submissions
| Command | What it does |
|---|---|
| f!forms submissions <form> [status] | List submissions. The default is pending; use all, in_progress, accepted, declined, or withdrawn for another view. |
| f!forms submission <id> | Show a submission and all of its answers. |
| f!forms reason <id> <reason> | Decline a pending submission and save the reason. |
| f!forms repost <id> | Repost a pending review message if the original was lost. |
| f!forms withdraw <id> | Withdraw your own in-progress or pending submission. Admins can withdraw any submission. |
Reviewers can also use the reaction controls on the review message: ✅ accepts, ❌ starts a decline, and the arrows browse long submissions. If the bot cannot DM a reviewer for a decline reason, use the reason command instead.
Review examples
f!forms submissions StaffApp
f!forms submission 123456789012345678
f!forms reason 123456789012345678 Not enough availability