Search Select Component

The Search Select component is a select control with a built-in search filter, making it well suited for large option lists. Like the Simple Select component, it supports single or multiple selections and can load options manually or from another field.

How to read settings tables
The tables below describe each configurable option as it displays in the UnqorkAI platform. Values are formatted as follows: inline code — a value to type exactly as shown | Bold — a value selected from a drop-down, radio button, tab, or choice chip | ON/OFF — toggle state | ✓ — checkbox checked | ☐ — checkbox unchecked

General Settings

Setting	Field	Type	Default	Description
Property ID	`key`	Text input	`searchSelect`	The unique identifier for this component instance.

Display Settings

Field Text

Setting	Field	Type	Default	Description
Label Text	`label`	Text input	—	Identifies the component on the canvas and informs end-users what information is requested.
Placeholder Text	`placeholder`	Text input	—	Hint text displayed inside the input before a selection is made.

Formatting

Setting	Field	Type	Default	Description
Allow Multiple Selections	`multiple`	Toggle	OFF	Lets end-users select more than one option from the list.
Allow Option Creation	`creatable`	Toggle	OFF	lets end-users enter any text as a new option and use it as the field value.
Render Select Menu as Portal	`renderAsPortal`	Toggle	ON	Attaches the drop-down menu to the HTML body as a portal instead of keeping it inside the parent DOM hierarchy.

Data Settings

Data Source Type

Setting	Field	Type	Default	Description
Data Source Type	`dataSrc`	Choice chip	Values	Sets how options are loaded.

Values — Manually define a list of options.
Column
Field
Type
Description
Key
key
Text input
The stored value for the option.
Option Label
label
Text input
The display text shown to end-users for each option.

Column	Field	Type	Description
Key	`key`	Text input	The stored value for the option.
Option Label	`label`	Text input	The display text shown to end-users for each option.

Data Reference Key — Load options from another module field.
Setting
Field
Type
Description
Data Reference Key
data.dataReferenceKey
Property ID
The Property ID of a field that returns a JSON array to use as the option source.
Key Property
data.keyProperty
Text input
The property in each item to use as the stored value.
Label Property
data.labelProperty
Text input
The property in each item to use as the display label.

Setting	Field	Type	Description
Data Reference Key	`data.dataReferenceKey`	Property ID	The Property ID of a field that returns a JSON array to use as the option source.
Key Property	`data.keyProperty`	Text input	The property in each item to use as the stored value.
Label Property	`data.labelProperty`	Text input	The property in each item to use as the display label.

Data Storage

Setting	Field	Type	Default	Description
Store Data in Database	`persistent`	Toggle	ON	When set to ON, this setting this setting stores field values to the database when the module saves, end-users navigate between Panel components, or end-users navigate between workflow screens. Set to OFF to exclude this field from server-side submissions.

Fields with Store Data in Database set to OFF are excluded from Plug-In component's API responses and Unqork's built-in tracker. When using a Plug-In component to remote-execute a module, any component whose value must be included in the API response requires Store Data in Database set to ON.

Validation Settings

User Input

Setting	Field	Type	Default	Description
Required	`validate.required`	Toggle	OFF	Requires a selection before the module can be submitted.
Required Error Message	`errors.required`	Text input	`is required`	Displays when the required field has no selection.

Operations Builder

This component supports the Operations Builder in Vega modules. When the module or panel runtime is set to Vega (2.0), an Event Handlers section displays in the settings panel for configuring event-driven operations.

Changelog

Date	Change
—	Initial publication.