Iris
Add to Discord

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 and name it. The designer opens on Form Basics.
  3. Pick the channel the apply panel is posted in.
  4. Write your questions on Questions, marking the optional ones as not required.
  5. Style the panel on Appearance: the embed, the apply button label and its colour.
  6. Set the review channel, reviewer roles and what approval grants on Review & Outcomes.
  7. Save, then post the panel.

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.
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.
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.

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 RolesGrants the approval roles when an application is accepted.

What it looks like#

I
Iris APP Today at 8:53 PM
Application Form

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

I
Iris APP Today at 8:53 PM
Staff application

Submitted by @applicant

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.

Approve or deny with the buttons below
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.