Forms

​

Overview

​

Set up a form in five steps

1

Create it

!form create staff Staff application makes a form called staff with the title members see (45 characters). A new form is closed until you open it.

2

Add the questions

!form question add staff short How old are you? adds a question at the end. See Questions for the types and options.

3

Pick the review channel

!form set staff channel #applications is where the cards arrive. A form without a review channel cannot be opened.

4

Open it

!form open staff lets members answer it.

5

Post a panel

!form panel #apply staff posts a button that opens the form. One panel can open several forms: !form panel #apply staff partner --style select makes a menu instead of buttons, and --web yes adds a Fill on the web link button.

​

Commands

!form create <name> [title]
!form delete <form>
!form list
!form info <form>
!form open <form>
!form close <form>
!form relink <form>
!form set <form> <setting> <value>
!form message <form> <submitted|accepted|denied> [text] [template]
!form questions <form>
!form question add <form> <type> <label> [required] [help] [description] [image] [placeholder] [min] [max] [options] [choices]
!form question edit <form> <position> <field> <value>
!form question move <form> <from> <to>
!form question remove <form> <position>
!form panel <channel> <forms> [style] [template] [title] [description] [web]
!form submissions [form] [status]
!form view <number>
!form accept <number> [reason]
!form deny <number> [reason]
!form retention [days]

!form create staff "Staff application"
!form question add staff paragraph Why do you want to join the staff?
!form question add staff choice Which timezone are you in? --options "America|Europe|Asia|Other"
!form set staff channel #applications
!form set staff accept-roles @Helper
!form open staff
!form panel #apply staff --web yes
!form accept 12 Welcome to the team!

!form list

!form close

!form delete

​

Questions

• required: whether an answer is needed (yes by default).
• help: a line under the question, up to 100 characters. Discord shows it under the field.
• description: a longer text, up to 1,000 characters, with bold, italics and links. The web page shows it whole; Discord shows its start when there is no help line.
• image: a picture over the question on the web page, an https link to a .png, .jpg, .gif or .webp file.
• placeholder: the grey text in the empty field.
• min and max: the length of a text, or the range of a number.
• options: for choice and multi, separated by |.

!form question edit staff 2 description Tell us about **any** server you helped run. [Our rules](https://example.com/rules)
!form question edit staff 2 image https://example.com/banner.png
!form question move staff 3 1
!form questions staff

!form question edit

!form question move

!form question remove

!form questions

Page 1 of 2

Next

A wrong answer

Sent

​

Settings

​

Messages to the member

• submitted: when the answers are sent.
• accepted and denied: the DM with the result.

!form message staff accepted "Welcome to the team, {user}! Read #staff-rules first."
!form message staff denied --template staff-denied

!form message staff accepted

!form message staff submitted

​

Reviewing

• Accept and Deny (with an optional reason the member reads). The roles of the form are given and taken, the member gets a DM and the forms category of the log gets a line.
• Open thread opens a thread under the card to talk about the answer.

Accept

The card after

!form accept

!form deny

!form submissions

!form view

​

The web page

• !form info <form> gives the link, petto.sbs/form/<id>, where the id is 12 random letters and numbers (/es/form/<id> and /pt-br/form/… open it in Spanish or Portuguese). Pasted in Discord or other apps, it shows a preview with the title, the description and the banner of the form. Older petto.sbs/form#… and petto.sbs/f/… links still work.
• Links are random, so nobody can guess them. !form relink <form> makes a new one, and the old one stops working at once. Panels posted before keep the old link, so post them again.
• !form set <form> web off keeps a form in Discord only.

!form info

!form relink

!form set staff color #ff91c2
!form set staff banner https://example.com/staff-banner.png
!form set staff background gradient
!form set staff server-icon off

• Color: the accent of the page (buttons, links, numbers).
• Banner: a picture on top (an https link to a .png, .jpg, .gif or .webp).
• Background: default (Petto’s), solid (a tint of the color) or gradient. With Premium there are also two animated ones, aurora and waves, made from the color of the form; they move slowly and stay still for visitors whose device asks for less motion.
• Server icon and server name in the header, each can be hidden.
• Branding: with Premium, !form set <form> branding off hides the small “Forms by Petto” line at the bottom of the page.

​

Storage and limits

​

Dashboard

• Forms: make and edit forms, their questions (with the description and the image), the rules, the roles, the messages and the web page.
• Form submissions: the answers by form and state, with a search, and Accept and Deny.
• Form panels: post a panel with buttons or a menu.

Forms

Form submissions

Form panels

​

Common issues

Members say the form is not ready

The form has no review channel. Set one with !form set <form> channel #channel.

The panel button does nothing

The form is closed. Open it with !form open <form>. !form panel reminds you which forms of the panel are closed.

An old web link does not open

The form was relinked. Use the new link from !form info, and post the panels again.

A role was not given

The role is above Petto’s highest role or is managed by an app. Move Petto’s role above it, see Permission issues.