# 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

  1. Click the 'Add line item' Green plus icon 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.

  2. Choose the item type. The various data types are described in full below.

  3. Enter the item prompt. This communicates what kind of resonse we are expecting from this item.

  4. 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 File tree icon button to expand the sub-items drop-down. Then, click the Green plus icon 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.

  1. You may want to reorder your form items. To do this, drag and drop using the Drag vertical icon handles. This applies to top-level and sub-items.

  2. To remove an item, click the Red close icon 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.

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 Red close icon Red close icon Red close icon
Image header Red close icon Red close icon Red close icon
Free text Green check icon Green check icon Red close icon
Yes/No Green check icon Red close icon Green check icon
Yes/No/NA Green check icon Red close icon Green check icon
Combobox Green check icon Red close icon Green check icon
Checkboxes Red close icon
Optional, user may select none of the checkboxes
Red close icon Green check icon
Document Green check icon Red close icon Red close icon
Image Green check icon Red close icon Red close icon
Date Green check icon Red close icon Red close icon
Time Green check icon Red close icon Red close icon
Datetime Green check icon Red close icon Red close icon
Permit link Green check icon Red close icon Red close icon
Table Green check icon Red close icon Red close icon
Last Updated: 20/01/2025