A request form is what owners fill in to ask for something: an architectural change, a repair, a pool key. You choose the questions.
You need full write access to Requests to create a form.
If you have no forms yet
The Requests page offers three starting points: General Request, Maintenance Request and Architectural Request. Pick one, or Start from scratch.
Each starting point creates a form with the same three questions: Title, Message and Attachment. Change the questions to fit, then add statuses and approvers. Starting points only show until you have your first form, and only to people with full write access to Requests.
Create a form
On Requests, click Create → New form.
Under Form details:
Form name, such as "Architectural Review Request".
Form description: what the form is for and anything owners should know first.
Requires unit association (on for a new form): leave it on if every request must be tied to a unit, as with an architectural request. Leave it off for requests that aren't about one unit, such as a common-area repair.
Save uploaded files to: optionally pick a Documents folder for files owners attach. See Save request uploads to Documents.
Form icon: click Change icon.
Under Add a document (optional), upload a Supplemental document, such as your architectural guidelines, and add a File description. Owners see it on the form. It must be under 100 MB and one of these types: JPG, JPEG, PNG, GIF, BMP, TIFF, WEBP, HEIC, HEIF, PDF, DOC, DOCX, XLS, XLSX, TXT, CSV or RTF. Any other type shows Invalid File … is not allowed. A form can have one supplemental document. To give owners several, such as guidelines plus a fee schedule, combine them into one PDF, or put the extra files in Documents and link to them in the form description.
Under Form questions, add your questions (see below).
Click Show preview to see the form as owners will.
Click Create new form.
You'll see This form has been saved. If you attached a document, it says Form saved and attachment uploaded.
After you save, you can still see what you uploaded and preview the form. Click Form settings on the form's card: the uploaded document is on the Form editor tab with a View button, and Show preview is at the bottom of that tab. Owners see the document as Attachment on the form when they start a request. See See a saved form, and the document you uploaded, as owners see them.
A form that doesn't require a unit still asks for one when you submit it. Turning off Requires unit association makes the unit optional; it doesn't remove it. When you submit a request on that form with Create → New submission, the Related to a unit switch is there and starts turned on, so Submit answers Please choose at least one unit. until you pick a unit or turn Related to a unit off. An owner who submits the form from their own unit's Requests tab isn't asked: their request is filed under that unit. See Without a unit.
Questions
For each question, choose a Field type, type the Question text, and tick Required if owners must answer it.
Field type | Use it for |
Text input | A short answer, such as a contractor's name |
Textarea | A longer description |
File upload | Plans, photos or a contractor's quote |
Checkbox | Yes/no, such as "I agree to the guidelines" |
Dropdown (choose one) | One choice from a list, such as the type of project |
Dropdown (choose multiple) | Several choices from a list |
Required on a Checkbox question means the box must be ticked. An owner who leaves a required checkbox unticked can't submit the form, so use it for statements such as "I have read the guidelines". Don't mark a checkbox Required if leaving it unticked is a valid answer (a plain yes/no): make it optional, or use a Dropdown (choose one) with Yes and No. If owners can still submit with a required checkbox unticked, contact PayHOA support with the form's name, the question and the ID of a request where it happened.
For dropdowns, type each choice under Field options. Click Add option for more. Every option needs a name, or you'll see Each option needs a name.
Question text can be up to 1,200 characters. A plain text block can be up to 2,400. The builder shows how many characters remain.
To organize a long form:
Add plain text adds instructions between questions.
Add divider adds a line between groups of questions.
Drag questions to reorder them. Expand all and Collapse all help on long forms.
Put a short title question first
The order of your questions decides how each request shows on the requests list, including the list that opens from a form's tile on the dashboard. A row doesn't show a title: it shows the first question the owner answered and their answer to it, with +n more for the rest. File uploads are skipped. So if your first question is long, or is a checkbox such as "I agree to the guidelines", every row looks the same.
To make requests easy to tell apart, make the first question a short Text input such as Title or What is this request about?, and tick Required. On a form you already have, open it for editing, add the question or drag it to the top, and save. There's no setting to show a title instead. Requests submitted before the change keep showing one of the answers they were submitted with.
To remove a question, click its remove icon. A question that's already been saved greys out as (removed) until you save, so you can undo it. A question you haven't saved yet is removed straight away.
Tip: to let owners send photos or plans, add a File upload question. Mark it Required if every request needs one.
After you create it
The form is turned on and visible to owners as soon as you save it. Before you tell owners about it:
Add statuses. New forms have none, so owners see an empty status. See Set up statuses.
Choose who gets emails. See Choose who gets request emails.
Add approvers, if the board or a committee must approve requests. See Set up approvals.
Give committee members access. See Give committee members access to a form.
To hide the form while you set it up, turn on Hide from homeowners. See Edit, hide, disable or delete a form.
