Built-in Schema Fields

RadioGroupField

Basic Usage

Use RadioGroupField when the schema needs a single choice from a small set of visible options.

Supporting Descriptions

When each radio choice needs a little more context, add a description to the option so the user can understand the tradeoff without extra surrounding copy.

Registry

  • Key: radioGroup
  • Module: src/forms/fields/RadioGroupField.tsx

Role in SchemaForm

Single-value choice UI using RadioGroup and RadioGroupItem, bound via useEngineField. Options come from field.options: { value, label, description?, disabled?, if? }[]. Option visibility can use per-option if (JEXL), just like SelectField.

Example schema

json
{
  "$field": "radioGroup",
  "name": "audience",
  "label": "Audience",
  "options": [
    { "value": "team", "label": "Team" },
    { "value": "private", "label": "Private" }
  ]
}
Edit this page
Last updated: May 22, 2026, 6:53 PM