Single-Select

A single-select component is used to capture a choice from up to 10 options that you provide. You can submit the value of the select option by:

  • Adding an action to the single-select component
  • Using a button component (which will submit all interactive components in the canvas)

When a submit action takes place, the results are given in a hash with the id from the single-select component used as the key and the id from the chosen option as the value.

Single-Select Parameters

ParameterPossible ValuesRequiredDescription
typesingle-selectYesThe type of component you are rendering.
idAny stringYesA unique identifier for the component.
optionsArray (See Below)YesThe list of options.Can provide 2 to 10.
labelAny stringNoThe text shown above the options.
valueThe id of an optionNoThe option that is selected by default.
save_stateunsaved``saved``failedNoStyles the input.Default is unsaved.Prevent action with saved.
disabledfalse``trueNoStyles all options and prevents the action.Default is false.Will be overriden if save_state is saved.
actionAction ObjectNoThis can be a Submit Action, URL Action, or Sheets Action.

Options Parameters

ParameterPossible ValuesRequiredDescription
typeoptionYesThe type of component you are rendering.
idAny stringYesA unique identifier for the option.
textAny stringYesThe text shown within this option.
disabledfalse``trueNoStyles the option and prevents the action.Default is false.

Preview