# Form builder
Civillo's Form Builder allows you to easily create and customize forms that users can fill out. This versatile tool provides the flexibility to structure forms with various field requirements and conditional logic, ensuring consistent user interaction and data collection.
Each form is structured as a collection of individual items, each serving a specific purpose. These items are the building blocks of the form and can vary in type, allowing for a diverse range of user inputs. Each item typically represents a single field of the form.
# Building a form
Click the 'Add line item'
button in order to add an item to your form. There is no upper limit on how many items you can add, but there must be at least one.
Choose the item type. The various data types are described in full below.
Enter the item prompt. This communicates what kind of resonse we are expecting from this item.
Add sub-items. Based on the user inputted value for this item, you may conditionally add sub-items. To add sub-items, first click on the
button to expand the sub-items drop-down. Then, click the
button against the conditional response for the parent item. When the parent value is equal to this conditional response, the user will be presented with the relevant sub-item/s to fill out.
TIP
For example, you might create an item with the 'Yes/No' prompt type, and add a sub-item with the 'Yes' conditional response. In this case if the user answered 'Yes' to the top level question they would then be required to fill out the sub-item. If they answered 'No', they would simply move on to the next item.
WARNING
Please note that Civillo currently only supports one level of sub-items. Sub-items cannot have sub-sub-items and so on.
You may want to reorder your form items. To do this, drag and drop using the
handles. This applies to top-level and sub-items.
To remove an item, click the
button.
# Data types
# Text header
Appears as highlighted text in the form, useful for breaking up the form into logical sections. Does not require user feedback.
# Image header
Display the provided image within the form. Does not require user feedback.
# Free text
Type anything into a text-field. Optionally, include a default value that will pre-fill the text-field.
# Yes/No
Choose between 'Yes' and 'No'.
# Yes/No/NA
Choose between 'Yes', 'No' and 'N/A'.
# Combobox
Define a variety of custom options for the user to choose from. The user will be allowed to select one.
# Checkboxes
Define a variety of custom options for the user to choose from. The user will be allowed as many as they like (including none).
# Document
Allows the user to attach a file.
# Image
Allows the user to attach an image file. (Limited to .jpeg or .png).
# Date
Select a date.
# Time
Select a time.
# Date time
Select a date and time.
# Permit links
Define one or more permit types. The user will be able to select one or more permits from the pre-defined types. If no type is selected, users will be allowed select any permit.
# Table
Define one or more column names, along with individual titles prompts for each cell. The user will be able to add rows (minimum 1) and fill out the cells accordingly.
# Data type overview
Data type | Requires user input | Optional Default value | Sub-items allowed |
---|---|---|---|
Text header | ![]() | ![]() | ![]() |
Image header | ![]() | ![]() | ![]() |
Free text | ![]() | ![]() | ![]() |
Yes/No | ![]() | ![]() | ![]() |
Yes/No/NA | ![]() | ![]() | ![]() |
Combobox | ![]() | ![]() | ![]() |
Checkboxes | ![]() Optional, user may select none of the checkboxes | ![]() | ![]() |
Document | ![]() | ![]() | ![]() |
Image | ![]() | ![]() | ![]() |
Date | ![]() | ![]() | ![]() |
Time | ![]() | ![]() | ![]() |
Datetime | ![]() | ![]() | ![]() |
Permit link | ![]() | ![]() | ![]() |
Table | ![]() | ![]() | ![]() |