The Query Component runs a Query Smart Component definition inside a module. It becomes available in the component tray after a Query Smart Component is created and shared, and Creators use it to retrieve and store query results without writing code.
Adding to a Module
The Build Agent places a Query Component automatically when Creators ask it to add a smart query to a module. It wires the component to the Query Smart Component definition it creates, maps the input parameters, and places the component on the canvas.
Creators can also add a Query Component manually. When a Query Smart Component is Public, it displays as a preset item in the QUERY section of the Config View component tray. Dragging a preset onto the canvas places a Query Component pre-configured to run that definition.
The QUERY section in the component tray carries the UnqorkAI sparkle icon to indicate that Query Components are powered by UnqorkAI. The section displays only when UnqorkAI is enabled for the workspace. Each item in the section uses the Smart Components icon and represents a single shared Query Smart Component.
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
The Property ID (key) and Description fields appear in the component panel header above the settings sections.
Configuration
The Configuration section maps module data to the query definition's input parameters. Each row binds a parameter declared in the Query Smart Component to a module component that supplies its value.
| Setting | Field | Type | Default | Description |
|---|---|---|---|---|
| Query Inputs | dataInputObject |
Table | — | Maps each query input parameter to a module component by alias. Add a row for each parameter the query definition declares. |
Outputs
The Outputs section defines where the component stores the data the query returns. The query definition's output schema determines the shape of the results slot.
| Setting | Field | Type | Default | Description |
|---|---|---|---|---|
| Outputs | dataOutputObject |
Table | — | Maps the query's return data to module component property IDs. The results slot stores data from a successful query run. The error slot stores a code, message, and optional errors detail when the query fails. |
Triggers
| Setting | Field | Type | Default | Description |
|---|---|---|---|---|
| Trigger Type | triggerType |
Drop-down | Manual | Sets when the query runs. Options include: Manual or Watch. |
| ↳ Set Debounce | debounceSetting |
Number input | 500 |
The delay in milliseconds before the query runs after an input changes. Visible when Trigger Type is set to Watch. Accepts values of 0 or greater. |
| Triggered By | — | Read-only display | — | Displays the components that this Query Component. Trigger wiring is set on the triggering component, not here. |
| Post Trigger | postTrigger |
Property ID | — | The component to trigger after the query runs successfully. |
| Error Trigger | errorTrigger |
Property ID | — | The component to trigger when the query returns an error. |
Changelog
| Date | Change |
|---|---|
| 2026-10-08 | Terminology: "shared (marked as discoverable)" → "Public"; See Also link text "Smart Queries" → "Query Smart Components". |
| 2026-09-15 | Restructured settings — removed General Settings and Actions Settings headings (not real UI sections); Property ID and Description noted as panel header fields; Configuration, Outputs, Triggers are collapsible sections; fixed two broken See Also paths. |
| 2026-08-21 | Article created. |