The Field Builder is where you define a reusable field: one field, with its type, label and full configuration, that you can reuse across your forms. You open it from the Fields library (AI Applications → Fields) with Open in Builder. For the library itself, see Reusable Forms & Fields.
Overview
Each reusable field is defined by a Field Builder block. The block holds exactly one field. It isn't a block you drag onto a page, and it draws nothing in a running app. Forms that use the field show it instead.
Note: The Field Builder doesn't let your app's users design forms at runtime. To let users build or edit a JSON schema in a running app, use the JSON Schema Editor block.
When to Use
Define one field, with its type, validation and options, that several forms should share.
To lay out many fields in one form, use the Form block instead.
Properties
The Field properties panel has two tabs: Content and Input. The Field Builder has no appearance settings, no events and no methods.
Content
Setting | Description |
|---|---|
Field type | The kind of field, for example text, number or date. Defaults to text. |
Label | The field's display label. |
Field configuration | Validation, options and the other settings for the chosen field type. You set these with the same field editor the Form block uses. |
Input
Add named inputs for the field, in the same way you add page inputs. Each input is a key and value that the field's configuration can reference.
Create a Reusable Field
In the left navigation, go to AI Applications → Fields. Click Create Field, or open an existing field, then click Open in Builder. The Field Builder opens with the field selected.
In the Content tab, keep the default field type or pick the type you need.
Set the label, validation and any options. The center canvas shows a live preview of the field.
Optionally, add inputs in the Input tab.
Click **Save** (unless your workspace saves automatically), then click **Publish** so your forms can use the field. Publish stays disabled while there are unsaved changes.
Use the field in your forms. See Reusable Forms & Fields for the Fields library, versions and reusable forms.
Behavior & Gotchas
Note: The canvas stays empty until your first edit. A new field shows "Configure the field in the properties panel" in the center, even though the Content tab already shows a starter field. Make any change in the Content tab to see the preview.
Note: Changing the field type keeps your existing configuration. After you switch types, review the type-specific settings and update them.
Note: The properties panel shows the Content and Input tabs only while the field is selected. If you see "Property controls will appear here.", select the field again.
Tip: If the label stored on the field and the title in the Content tab's field editor ever differ, users see the title from the field editor. Set the label you want users to see there.