Select

A dropdown menu for selecting a single value from a list of options. Renders as an HTML <select> element.

Properties

Property	Type	Default	Description
name	text	''	The field name. Must match your database column name.
label	text	''	The visible label displayed above the dropdown.
required	boolean	false	Whether the field is required for form submission.
value	text	''	Pre-select an option by its value. Supports expression binding (e.g., {{ item.status }}).

Options are configured in the property panel as an array of value/label pairs.

Events

• onChange -- Fires when the selected option changes.

Example

A status selector:

name: status
label: Status
options:
  - value: draft, label: Draft
  - value: active, label: Active
  - value: archived, label: Archived

A category selector:

name: category_id
label: Category
options:
  - value: 1, label: Electronics
  - value: 2, label: Clothing
  - value: 3, label: Books

An edit form with a pre-selected status:

name: status
label: Status
value: "{{ item.status }}"
required: true
options:
  - value: draft, label: Draft
  - value: active, label: Active
  - value: archived, label: Archived

Tips

• Place inside a Form Container for the value to be included in form submissions.
• The value of the selected option is what gets submitted, not the label.
• For dynamically loaded options (from a database table), consider the Relation Picker widget which auto-populates options from a data source.
• For filtering data (not form input), use a Select widget with an onChange event to trigger pipeline filtering.
• Style the dropdown via the Design tab (border, padding, font, background).