Form builder

The form builder is where you design the structure of your form. It is split into three panels:

• Field palette (left) — click any field type to add it to the canvas.
• Canvas (centre) — shows all fields in order; drag the handle on the left of any card to reorder.
• Field editor (right) — appears when you select a field; lets you edit its properties.

Adding a field

Click a field type in the palette. The new field is appended at the bottom of the canvas with a default label. Click the field card to open the editor and customise it.

Editing a field

The field editor exposes the following properties for every field:

• Label — the question text shown to respondents. Required.
• Placeholder — hint text shown inside the input. Optional.
• Required — toggle on to prevent form submission unless this field is filled.

Choice fields (Multiple choice, Checkboxes, Dropdown) also show an Options editor where you can add, edit, and remove the selectable choices.

Reordering fields

Grab the drag handle (⠿) on the left side of a field card and drag it to the desired position. The order is saved when you click Save fields.

Deleting a field

Click the trash icon on the right side of a field card. Deleting a field that has already received answers will remove those answers from existing responses.

Saving

Click Save fields in the top-right corner of the builder. Changes are not auto-saved; unsaved changes will be lost if you navigate away.

The form stays in Draft status after saving. Saving does not publish the form. To publish, go to the form detail page and click Publish.

Repeating groups

You can group fields together and let respondents add multiple instances of the group (e.g. "Add another facility"). See Repeating groups.

Import from JSON

If you have a form definition as a JSON file, you can upload it directly from the Forms list page — no need to build the form manually. See Import from JSON.