Multi-Select Dropdown Component

The Multi-Select Dropdown component lets end-users select one or more options from a searchable drop-down list. Options can be defined manually, fetched from a URL, or loaded from another field. It includes advanced options for auto-selection behavior, clear buttons, item templates, and more.

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

Display Settings

Field Text

Contextual Help

Formatting

Default State Options

• Enable User Input (default): End-users can make selections in the drop-down.

• Disable User Input (disabled): Prevents end-users from making a selection. The component displays with an altered appearance to indicate it is not editable.

• Read Only - Legacy (readOnlyView): Displays the stored value as plain text without the drop-down input. Shows None when empty.

Data Settings

Data Source Type

Values — Manually define a list of options.

Column	Field	Type	Description
Option Label	label	Text input	The display text shown to end-users for each option.
Data Source Values	value	Text input	The value stored when the option is selected.

URL — Fetch options from an external endpoint.

HTTP request headers to include with the data fetch:

Column	Field	Type	Description
Request Header	label	Text input	The HTTP request header name.
Header Values	value	Text input	The value for the header.

Setting	Field	Type	Default	Description
Service	service	Service selector	—	A configured service to use as the data source.
Data Source URL	data.url	Text input	—	A URL that returns a JSON array to use as the option source.
Data Path	selectValues	Text input	—	The property  in the response where iterable items reside.
Filter Query	filter	Text input	—	Additional filtering using query parameters.
Refresh On	refreshOn	Property ID	—	Triggers a data refresh when the specified field changes.
Limit Number of Items	limit	Number input	—	Limits the number of items returned per page.
Disable Limiting Response	data.disableLimit	Toggle	OFF	Excludes limit and skip parameters from the query string.
Search Parameters are Required	hasRequiredFields	Toggle	OFF	Prevents the fetch from executing if required search parameters are absent.
Clear Value On Refresh	data.clearOnRefresh	Toggle	OFF	Clears the selected value when the Refresh On field changes.
Authenticate	data.authenticate	Toggle	OFF	Sends authentication headers from the application with the request.
Disable filter application	preventInnerFilter	Toggle	OFF	Prevents the component from applying its internal filter to results.
Value Property	valueProperty	Text input	—	The property in each item to use as the stored value.
Search Query Name	searchField	Text input	—	The URL query parameter name used to send the end-user's search text to the server.
Refresh Delay	refreshDelay	Number input	250	Sets the delay after the end-user stops typing before sending the search request, in milliseconds (ms).

Data Reference Key — Load options from another module field.

Setting	Field	Type	Default	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.
Limit Number of Items	labelPath	Number input	—	Limits the number of items returned.
Refresh On	refreshOn	Property ID	—	Triggers a data refresh when the specified field changes.

Data Storage

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.

Actions Settings

Triggers

Validation Settings

User Input

Advanced Settings