1. Fields
  2. Select Field

Fields

Select Field

Captures one values from a list. Useful for controlled choices, categories, statuses, and predictable downstream automation.

This can be used to select items from any list such as list of colors, months in a year, list of countries, etc.

Basic usage

Adds a select field to the fields of an action. Each option should have a label and a value. The label is the text that will be displayed to the user, and the value is the value that can be used in the action logic.

loading...

Parameters

See fields for common field parameters like validation and conditional rendering.


options
required
array

An array of option objects representing the list of items available for selection.

Show child attributes
label
required
string

The label of the option. This is the name that will appear to users in the form.

value
required
string

The value of the option. This is the value that will be set in the data of the field.


llm_options.pick_option_by
optional
string

Controls which part of each option is presented to an LLM when this field belongs to an action that is available for GPT Chat Task tool calling.

Set this parameter to "label" to build the tool parameter's enum from the option labels instead of the option values. This is useful when the values are internal identifiers, such as UUIDs, that would be difficult for the LLM to associate with the correct option.

The setting only changes how the LLM picks an option. When the action is submitted, Stubber resolves the selected label to its corresponding option and stores the underlying value in the field data.

Supported value: label

Default: The LLM picks from the option values.

Example using filenames as labels and UUIDs as values:

loading...

Result

The stubpost.data of the Basic Usage example will be:

loading...