Schema Fields

Schema fields are the parts of SchemaForm that use $field.

These are the nodes that bind to form values, render actual field UI, and participate in validation and error handling.

What makes something a schema field

A schema field usually does three things:

Reads its current value from the form engine.
Writes changes back to the form engine.
Renders field UI such as a label, instructions, control, and errors.

For example:

json

{
  "$field": "text",
  "name": "title",
  "label": "Title"
}

That tells SchemaForm to find the registered text field component and bind it to the title path.

Built-in schema fields

Plugin Kit ships these $field types as lazy builtins (React and Vue):

Each built-in field page explains the schema shape and behavior for that type.

Product-owned fields (not kit builtins)

Fields that encode product rules — Craft handles, Formie variables, element selectors, list/rich-text builders, static tables, formula editors — live in the consumer plugin and register via registerFormFields(). Formie does this with registerFormieOwnedSchemaFields (handle, list, richText, variablePicker, elementSelect, plus its own table variants).

Use Custom Schema Fields when your plugin needs a $field that is not in the kit list. For editable tabular data without a schema field, use the EditableTable component directly.

Field anatomy

Most schema fields follow the same basic anatomy:

value binding through the form engine
field UI such as label, instructions, and errors
the actual input component
optional validation and grouped error behavior

That shared shape is why different field types still feel consistent in the UI.

Anatomy props

Built-in schema fields pass their common presentation props through FieldLayout.

Prop	What it controls
`label`	The field label.
`required`	Adds the required indicator beside the label.
`instructions`	Supporting help text below the label. Supports inline Markdown, including code.
`errors`	Field-level validation messages below the control. Supports inline Markdown, including code.
`warning`	Non-blocking warning text below errors. Supports inline Markdown, including code.

Use plain text for most labels and messages. Use inline Markdown when the copy needs a link, emphasis, or a code-style token such as gmail.com.

Schema Fields ​

What makes something a schema field ​

Built-in schema fields ​

Product-owned fields (not kit builtins) ​

Field anatomy ​

Anatomy props ​