Skip to content
Formspace Docs

Button Group Question Schema Properties

A question that displays choices as a group of buttons.

Element type: buttongroup Key properties: 12

Generation Hints

Section titled “Generation Hints”
  • Aliases: segmented control, button choices, pill choices.
  • Use when: respondents choose from a small set of prominent options.
  • Recommended properties: type, name, title, choices, isRequired.
{ "type": "buttongroup", "name": "plan", "title": "Choose a plan", "choices": ["Basic", "Pro", "Enterprise"] }

Key Properties

Section titled “Key Properties”

choices

Section titled “choices”
  • Type: buttongroupitemvalue[]
  • Default: []

choicesByUrl

Section titled “choicesByUrl”
  • Type: restfull
  • Default: —

choicesFromQuestion

Section titled “choicesFromQuestion”
  • Type: question_carryforward
  • Default: —

choicesFromQuestionMode

Section titled “choicesFromQuestionMode”
  • Type: string
  • Default: "all"
  • Allowed values: all, selected, unselected

choicesVisibleIf

Section titled “choicesVisibleIf”
  • Type: condition
  • Default: —

choicesEnableIf

Section titled “choicesEnableIf”
  • Type: condition
  • Default: —

choicesOrder

Section titled “choicesOrder”
  • Type: string
  • Default: "none"
  • Allowed values: none, asc, desc, random

colCount

Section titled “colCount”
  • Type: number
  • Default: 1
  • Allowed values: 0, 1, 2, 3, 4, 5

showOtherItem

Section titled “showOtherItem”
  • Type: boolean
  • Default: —

showNoneItem

Section titled “showNoneItem”
  • Type: boolean
  • Default: —

showCommentArea

Section titled “showCommentArea”
  • Type: switch
  • Default: —

hideIfChoicesEmpty

Section titled “hideIfChoicesEmpty”
  • Type: boolean
  • Default: —

Shared Properties

Section titled “Shared Properties”

This page lists only properties that are specific to this element type or especially important for generation.

  • Use Shared Question Properties for common fields such as name, title, description, isRequired, requiredIf, visibleIf, enableIf, readOnly, defaultValue, validators, width, and layout options.
  • Use Shared Choice Question Properties for shared choice fields such as choices, choicesByUrl, choicesFromQuestion, showOtherItem, showNoneItem, and special choice labels.
  • Use Choice Item for object choices and Choices By URL for remote choice loading.