Field types
How it works
A field's type sets how it looks, what customers can enter and the built-in validation it gets. To add a field, see Build a form.
Standard input fields
Use these for basic customer information. They support validation such as required values, length limits and number ranges.
| Field | Best for |
|---|---|
| Text | Names, company details, references. |
| Contact email addresses. | |
| Long text | Longer notes or requests. |
| Number | Quantities, values or other numbers. |
| Phone | Phone numbers with country codes. |
| Password | Secure login or gated forms. |
| URL | Website addresses or other links. |
Date and time fields
Use these for dates and times, such as delivery dates. When you configure the field, you can set the allowed range and availability.
| Field | Best for |
|---|---|
| Date | Delivery dates, deadlines. |
| Time | Appointment times. |
| Date & Time | Combined date and time. |
Selection fields
Use these when customers choose from set options. Type the options yourself, or pull them from a data source with data references.
| Field | What it does |
|---|---|
| Select | A dropdown with one choice. |
| Multiple choice | Choose several options from a list. |
| Radio | One choice, with the options shown inline. |
| Toggle | An on/off switch, for example to confirm something. |
| Checkbox | An on/off choice shown as a checkbox. |
| Slider | A numeric range. |
| Country | One country. |
Advanced input fields
Use these for richer information.
| Field | Best for |
|---|---|
| Rating | Feedback or scoring. |
| Signature | Agreements or approvals. |
| File Upload | Documents, images and other attachments, such as a resale certificate. You can open them from the entry. |
| Hidden | Values customers don't see, such as tracking or integration data used by automations. |
| Tax Information | Tax details such as a VAT number or tax ID. |
| Workflow trigger button | A button that runs a workflow. Mostly used on internal fields rather than the customer-facing form. |
For developers: uploaded files
A File Upload answer is stored as a SparkLayer file ID. Use the Files API to turn it into a download link.
Structured fields
These fields create several sub-fields for you. That keeps answers consistent, especially for B2B account requests and onboarding.
| Field | What it includes |
|---|---|
| Name | Title, first name, last name. |
| Address | Street, city, postcode, country. |
Layout and grouping fields
Use these to organise the form.
| Field | What it does |
|---|---|
| Group | Keeps related fields together and lets you apply display logic to all of them at once. |
| Group with Repeatable on | Lets customers add the same set of fields more than once, for example one row per line item. |
See Group related fields for how groups work.
Content fields
These fields don't collect answers. Use them to guide customers through the form.
| Field | Best for |
|---|---|
| Heading | Section titles. |
| Paragraph | Instructions or context. |
| Image | Visual guidance. |
| Video | Embedded videos. |
| Button | A link or a workflow trigger. |
| HTML | Custom content blocks. |
Tips
- Use structured fields (Name, Address) for consistent answers.
- Use Select or Radio when there's a fixed set of answers.
- Break long forms into pages and groups.
- Only ask for information you need.
Last updated