The Forms tab provides a visual form builder for creating data collection forms on your published site. Forms can be linked from the top menu, sidebar, footer, or CTA buttons. Each form submits data to a configurable endpoint via HTTP POST.
Form Configuration
| Property | Description |
|---|
| Form ID | Unique identifier for the form (auto-generated) |
| Post URL | HTTP endpoint that receives the form submission (POST request) |
| Title | Form title displayed at the top |
| Description | Optional description text below the title |
| Success title | Title displayed after successful submission |
| Success message | Message displayed after successful submission |
| Failure title | Title displayed if submission fails |
| Failure message | Message displayed if submission fails |
| Redirect URL | Optional URL to redirect to after successful submission |
| Order | Display order if multiple forms exist |
Form Controls
Nine control types are available for building forms:
1. Textbox
| Property | Description |
|---|
| Label | Field label displayed above the input |
| Form name | Field name sent in the POST body |
| Placeholder | Placeholder text shown when empty |
| Required | Whether the field must be filled |
| Max length | Maximum character count |
2. Textarea
| Property | Description |
|---|
| Label | Field label |
| Form name | Field name in POST body |
| Placeholder | Placeholder text |
| Rows | Number of visible text rows (default: 4) |
| Required | Whether the field must be filled |
| Max length | Maximum character count |
3. Radio Group
| Property | Description |
|---|
| Label | Group label |
| Form name | Field name in POST body |
| Required | Whether a selection must be made |
| Options | List of label/value pairs for each radio button |
4. Toggle
| Property | Description |
|---|
| Label | Toggle label |
| Form name | Field name in POST body |
5. Select List
| Property | Description |
|---|
| Label | Field label |
| Form name | Field name in POST body |
| Required | Whether a selection must be made |
| Options | List of label/value pairs for the dropdown |
6. Checkbox
| Property | Description |
|---|
| Label | Checkbox label |
| Form name | Field name in POST body |
| Required | Whether the checkbox must be checked |
7. Hidden Field
A hidden field is not displayed to the user but is included in the form submission.
| Property | Description |
|---|
| Name | Field name in POST body |
| Value | Fixed value sent with every submission |
8. Email Field
| Property | Description |
|---|
| Label | Field label |
| Form name | Field name in POST body |
| Placeholder | Placeholder text |
| Required | Whether the field must be filled |
9. Button
| Property | Description |
|---|
| Label | Button text |
| Colour | Button style: primary, secondary, or tertiary |
Form Settings
| Setting | Description |
|---|
| Submit button position | Alignment of the submit button: left, centre, or right |
| Show required indicator | Display an asterisk (*) next to required field labels |
| Enable honeypot | Add a hidden field for spam protection. Bots that fill the hidden field are rejected. |
Managing Forms
Form Block
Embed data collection forms directly into any content page. Forms are defined in Site Settings and rendered inline with full validation, submission handling, and spam protection.
