Skip to main content

Field Editing

When a field is selected on the canvas, the EditPanel opens on the right side (desktop) or as a bottom drawer (mobile). The EditPanel has two tabs: Edit and Logic.

Edit Tab

Common Properties

Every field type has these editable properties:

PropertyDescription
QuestionThe label/question text shown to the user
RequiredWhether the field must be answered (toggle)

Type-Specific Properties

Additional properties appear based on the field type:

Text Fields (text)

PropertyEditor
Input TypeDropdown: string, number, email, tel, date, datetime-local, month, time, url
UnitText input for suffix (e.g. "kg", "cm")

Choice Fields (radio, check, dropdown, multiselectdropdown)

PropertyEditor
OptionsEditable list -- add, edit, delete, reorder options

The Option List Editor provides:

  • Text input per option to edit the value
  • Add button to append a new option
  • Delete button per option to remove it
  • New fields start with 3 placeholder options

Multi Text (multitext)

PropertyEditor
OptionsEach option becomes a labeled text input in the form

Rating (rating)

PropertyEditor
OptionsNumeric scale values (e.g. 1-5, 1-10)

Ranking (ranking)

PropertyEditor
OptionsItems that users will drag to order

Slider (slider)

PropertyEditor
OptionsRange values (first = min, last = max)

Matrix Fields (singlematrix, multimatrix)

PropertyEditor
RowsEditable list of row labels
ColumnsEditable list of column headers

The Matrix Editor provides:

  • Separate sections for rows and columns
  • Add, edit, delete for each row/column
  • New matrix fields start with 3 rows and 3 columns

Section (section)

PropertyEditor
TitleSection heading text

HTML (html)

PropertyEditor
HTML ContentText area for raw HTML

Image (image)

PropertyEditor
Image URIURL of the image
Alt TextAccessible alternative text
CaptionCaption below the image

Display (display)

PropertyEditor
ContentMarkdown text area (supports {fieldId} and <expression> syntax)

Signature / Diagram (signature, diagram)

PropertyEditor
PlaceholderText shown on the drawing canvas

Logic Tab

The Logic tab lets you configure conditional rules for the selected field. See the Conditional Logic reference for full details.

Rule Builder UI

The Logic tab provides a visual rule builder:

  1. Add Rule -- Creates a new conditional rule
  2. Effect -- Choose visible, enable, or required
  3. Logic Mode -- Toggle between AND (all must match) and OR (any can match)
  4. Conditions -- Add one or more conditions per rule:
  • Condition Type -- field (compare field value) or expression (custom expression)
  • For field conditions:
  • Target Field -- Select which field to evaluate
  • Operator -- Choose comparison (equals, contains, etc.)
  • Expected Value -- The value to compare against
  • Property Accessor -- Optional (length, count)
  • For expression conditions:
  • Expression -- JavaScript-like expression with {fieldId} references

Multiple Rules

You can add multiple rules for different effects on the same field. For example:

  • Rule 1: visible when payment method = "Credit Card"
  • Rule 2: required when checkout step = "Payment"

How Changes Are Saved

Every edit in the EditPanel immediately updates the FormStore. If an onChange callback is provided to the builder, it fires after each change with the updated FormDefinition.

There is no manual "save" action -- changes are applied in real-time.