Choice Item Schema

Choice items are used in choices, rows, and columns arrays for choice-based questions and matrix questions.

Use this object shape when a choice needs a display label, image, conditional visibility, or other metadata. For simple choices, a string is also valid.

Minimal Shapes

["Sales", "Support", "Operations"]

[
  { "value": "sales", "text": "Sales" },
  { "value": "support", "text": "Support" }
]

Nested Follow-up Questions

The underlying schema can represent elements inside radio/checkbox choices, but Formspace keeps this builder feature disabled until upload handling, internal-field filtering, workflows, and exports support those nested answers. Use separate questions or panels with visibleIf conditions for follow-ups.

Properties

value

• Type: string | number | boolean
• Required: Yes for object choices

The stored answer value. Keep values stable and machine-friendly, for example "sales" instead of "Sales Team".

text

• Type: string
• Localizable: Yes

The label shown to respondents. If omitted, Formspace displays the value.

visibleIf

• Type: condition

Boolean expression that controls whether this choice is visible.

enableIf

• Type: condition

Boolean expression that controls whether this choice is selectable.

imageLink

• Type: string

Image URL used by image picker choices.

description

• Type: string

Additional text shown with the choice where supported.

Example

{
  "type": "radiogroup",
  "name": "department",
  "title": "Which department should handle this?",
  "choices": [
    { "value": "sales", "text": "Sales" },
    { "value": "support", "text": "Support" },
    { "value": "other", "text": "Other", "visibleIf": "{companySize} > 50" }
  ]
}