Skip to main content

Radio

The radio field allows users to select a single option from a predefined list. It is ideal for forms where a single choice is required, such as selecting a gender, a payment method, or a preferred contact method.

Example

fields:
  preferred_contact:
    type: radio
    label: Preferred Contact Method
    options:
      email: Email
      phone: Phone

Field Properties

Name Type Default Description
aria string –

Optional aria label for better accessibility.
autofocus bool false

Set autofocus on field.
error string | array –

Costum error message for translation or customization.
help string | array –

Optional help text below the field
label string | array –

The field label can be set as string or associative array with translations
options array –

Defines the available choices for the radio field as key-value pairs. Each option_key must be unique, and the labels can support multiple languages.
required bool –

Defines whether the field is mandatory for form submission.
title string | array –

Tooltip displayed when the user hovers over the field (supports multilingual configurations).
width string 1/1

The width of the field in the 12 columns field grid.