Instance · Data
Data Source
Last updated 1 November 2026
The following UI element options are available for the 'Data Source' field type:
- Search
- Select
The following conditional fields are displayed for either of these UI elements:
| Input Label | Type | Required | Description |
|---|---|---|---|
| Data Source | Dropdown Field | Yes | Select the target database that will populate this field's options. This establishes a relational link between the current database and the selected source. |
| Display Field | Dropdown Field | Yes |
Determines which column from the source database is visible to the user. This allows you to store a technical ID (Foreign Key) while displaying a human-readable value, such as a name or title. This field only appears when a value is selected in the 'Data Source' field. |
| Mandatory | Toggle | No | When enabled, a selection must be made to save the record. If disabled, the field can remain unassigned. |
Search
Selecting this UI element displays a form with the following input requirements in the 'Appearance' tab:
| Input Label | Type | Required | Description |
|---|---|---|---|
| Show in table view | Toggle | No | Determines whether the selected data from this source is displayed as a column in the Instance Admin index. |
| Help Text (Tooltip) | Text Area | No | Instructional text that appears on hover. Use this to guide users on what type of data they are searching for or selecting. |
| Column Width in table view (%) | Number Field | No | Sets the horizontal width (1–100%) of the column in the table view to ensure the source data is fully legible. |
Select
The input requirements for this UI element's form in the 'Appearance' tab align with the inputs for the 'Search' UI element.