Iris
Add to Discord
Docs

Forms

Application forms with staff review and approval.

Configure Forms in the dashboard →

Overview#

Forms turns an application into a button. A member presses Apply, Iris asks your questions one at a time over direct message, and the finished answers arrive in your review channel as a single embed with Approve and Deny beneath it.

Because the questions are asked over DM rather than in a Discord modal, there is no length limit on a question or an answer, and a form can run to 20 questions without the member losing their place.

Approving can hand out a role and send the applicant a message. Denying can ask the reviewer for a reason and pass it on. Every submission is kept under Submissions, with volume and outcome charts under Statistics.

Setup#

  1. Open the dashboard and go to Community > Forms, then turn the module on.

  2. Press New form, or pick a ready-made one from Templates. The form opens in the editor, with a setup check and a live preview beside it.

  3. Write your questions under Questions. Each is either a typed answer or multiple choice, answered from a menu in the DM.

  4. Pick the panel channel and style the panel under Panel.

  5. Set the review channel, reviewer roles and what approval gives or takes away under Review and outcomes.

  6. Optionally limit who can apply under Who can apply, and reword the DMs under DM messages.

  7. Save, then press Post panel. Once a panel is live, saving a change to it updates the posted message.

Settings#

SettingTypeDefaultWhat it does
Form nameText-Internal name, used to tell forms apart.
Panel channelChannelNoneWhere the apply panel is posted.
Apply button labelTextApplyWhat the button on the panel says.
Apply button colourChoiceBlurpleBlurple, grey, green or red.
QuestionsList1 questionUp to 20, each with its own label, hint and required flag.
Answer typeChoiceTyped answerPer question. Multiple choice offers up to 25 options in a DM menu, optionally allowing several picks. Members can also type an option or its number.
Minimum / maximum charactersNumberNo limitPer typed question. An answer outside the range is refused and the member is asked to try again.
RequiredToggleOnPer question. A required question cannot be skipped.
Review ChannelChannelNoneWhere finished applications are posted for staff.
Reviewer rolesRolesNoneWho may press approve or deny.
Approval rolesRolesNoneRoles granted to the applicant on approval.
Roles taken awayRolesNoneRemoved from the applicant on any approval, such as a waiting Applicant role.
Review threadToggleOffOpens a thread on each review message for reviewers to discuss the applicant.
Ask for a deny reasonToggleOnPrompt the reviewer for a reason when denying.
DM on approveToggleOnTell the applicant they were accepted.
Approve messageTextNoneWhat that DM says. Blank sends the default wording.
DM on denyToggleOnTell the applicant they were denied.
Deny messageTextNoneWhat that DM says, alongside the reason if one was given.
OpenToggleOnAccepting applications. Turn off to close a form without deleting it.
Cooldown (seconds)Number0How long a member waits before applying again. 0 is no wait.
One pending applicationToggleOnStops a member queueing several applications at once.
Required roleRoleNoneOnly members with this role may apply.
Blocked rolesRolesNoneMembers holding any of these cannot apply.
Time in the server / account ageDaysAnyMinimum days since joining the server, and since the Discord account was made. A member who is too new is told when they can apply.
Opening messageTextNoneReplaces the first DM. A line saying they can type cancel is always added.
Confirm each typed answerToggleOnShows each answer back with Confirm and Cancel. Off saves answers as soon as they are sent.
End the interview afterMinutes30How long the DM interview waits for a reply before it ends. 5 to 180.
Confirmation messageTextNoneReplaces the DM sent once the application is submitted.

Commands#

Forms is dashboard only. Members apply from the panel, and staff decide from the buttons on the review message.

Permissions#

PermissionWhy Iris needs it
View ChannelsSees the panel and review channels.
Send MessagesPosts the panel and each finished application.
Embed LinksThe panel and the review message are embeds.
Manage RolesGives and removes the approval roles when an application is accepted.
Create Public ThreadsOnly with review threads switched on.

What it looks like#

I
Iris APP Today at 11:22 PM
Application Form

Interested in joining? Click Apply below and answer a few questions to submit your application.

Apply
I
Iris APP Today at 11:22 PM

Application from @applicant for Staff application

Why do you want to apply?

I moderate two other servers and I am on daily.

What timezone are you in?

GMT, usually around in the evenings.

Submission stats

User ID: 123456789012345678
Username: applicant
User: @applicant
Duration: 96s
Joined guild 2 months ago
Submitted 4 minutes ago

Status

Pending review

Approve Deny
The apply panel, and a finished application waiting on review.

Tips and gotchas#

A member says the bot never messaged them.

Their DMs are closed to server members. They have to allow direct messages from this server, then press apply again.

Can I run more than one form?

Yes. Staff applications, partner requests and event signups can each be their own form with their own reviewers.

Approval did not grant the role.

The role sits above Iris in the role list. Drag Iris above it.

Can applicants edit an answer?

Not once submitted. Deny it with a reason, and let them apply again after the cooldown.