Quickstart
This guide walks you through creating an account, building a form, and sharing it with respondents — in under five minutes.
1. Create an account
Go to the registration page and enter your name, email address, and a password. The first account created on a fresh install is automatically given the Admin role; all subsequent accounts are given the Organiser role by default.
2. Create a new form
- After signing in, click Forms in the left sidebar.
- Click New form in the top-right corner.
- Enter a title and an optional description, then click Create form. You will be taken directly to the form builder.
3. Add fields
In the form builder you will see a field palette on the left listing all available field types and containers. Click any type to append it to the canvas, or drag it to a specific position.
Click the pencil icon on a field card to open its editor modal, where you can change the label, add a placeholder, toggle required, and (for choice fields) manage the list of options.
See Field types for a full description of every field.
4. Edit the title and description
The form title and description are editable directly in the builder header — click on either to start typing. They are saved along with the fields when you click Save.
5. Save your form
Click Save at the top of the builder. The form is saved as a draft and is not yet visible to respondents.
6. Preview the form
Click Preview to open the fill-out view in a new tab. This lets you check the layout and required-field validation before publishing.
7. Publish
Click Publish in the builder header (or on the form detail page). The form status changes from Draft to Published and a shareable link becomes active. Send this link to your respondents.
You can optionally set an expiry date before publishing — the form will close automatically at that date and time.
8. View responses
Open the form detail page and click Responses to see a table of all submissions. The stats dashboard shows a response-rate chart and per-field answer breakdowns. Click Export CSV to download all responses as a spreadsheet.
Next steps
- Field types — full reference for all 11 field types.
- Repeating groups — let respondents add multiple entries.
- Visibility & allowlists — restrict access to specific email addresses.
- Import from JSON — create forms programmatically from a JSON file.