Building a form
The editor is a document, not a settings page. You write the form by listing its fields and widgets. Forms handles labels, ordering, requiredness, the public renderer, and (when you want it) the printed PDF.
The structure of a field
Every input field has three things:
- A label — what the respondent reads.
- A type — what kind of input they give back. See Field types for the full list.
- Required toggle — whether the form will accept a submission with this field empty.
Document widgets (Header bar, Image, Table, Totals, Card, Page break, Spacer, Divider) don't collect input — they're for layout. See Documents & PDFs for what each one does.
Adding fields and widgets
Click Add field at the bottom of the editor. A color-coded menu pops up — inputs in teal, layout widgets in red, utility widgets in muted grey. Pick one; it's appended to the form with sensible defaults and your cursor jumps in so you can rename it immediately.
Or describe it in plain English
Above the field list, the AdaptGent bar lets you type or dictate the form you want — “header bar, then name, email, and phone on one row, below that a signature” — and Forms assembles every widget in one shot. Voice input runs on your browser's native speech recognition (no audio leaves your machine). See AdaptGent (voice) for the full vocabulary and example phrasings.
Reordering
Each field shows a grip handle on its left edge. Click and drag to reorder. Drag handles work for nested children inside a Columns widget too — they reflow to the right slot as you drop them. Changes save automatically.
Required vs optional
Toggle Required on a field to mark it mandatory. The public form shows a red asterisk and refuses to submit if the field is blank.
Rich text in labels and paragraph blocks
Heading, Paragraph text, Short text and Long text labels open a TipTap rich-text editor when you click them. You get bold, italic, lists, links — what you'd expect. Plain text in, formatted text out, no Markdown to remember.
Choice fields (multiple choice, checkboxes, dropdown)
When you pick a choice-type field, an Options panel appears. Add one option per line. Reorder or delete them inline.
Columns
The Columns widget creates a 2- or 3-column row. Drop any field or widget into any slot. Use it to put Customer name next to Email, or to lay out three comparison Cards side-by-side. Only the top level of the form can hold a Columns widget — you can't nest one inside another.
Section headings & static text
Section heading renders as bold text on the public page and isn't collected — purely for layout. Paragraph text is a non-input block for clauses, instructions, or T&Cs; the content lives in the field label and renders with whitespace preserved.
Editing on mobile
On screens under 1024px the editor switches to a touch-friendly mode: tap any field to open it in a bottom sheet (no drag-required), edit the label and options there, swipe down to dismiss. Drag handles are hidden on mobile to avoid scroll conflicts — reorder on desktop or use the up/down buttons in the sheet.
Deleting a field
Hover any field on desktop (or open it on mobile) and click the trash icon. The field is removed immediately — no confirmation, because you can always re-add it in two clicks.
Renaming the form
Click the form title at the top of the editor to rename it. The title is what respondents see at the top of the public page and what the downloaded PDF is named after.
Branding (logo & brand color)
Open the form's settings to upload a logo (PNG, JPG, or WebP, up to 2 MB) and pick a brand color. These power the Header bar widget, the recommended Card accent, and the printed PDF. See Documents & PDFs for how it all fits together.
Next, decide how the form should print: Documents & PDFs. Or take it live: Publishing & sharing.