Unqork documentation is available in two workspaces: UnqorkAI for the latest AI-first platform, and legacy Unqork for previous versions. Use the drop-down near the logo to switch.

This article covers UnqorkAI features. UnqorkAI requires an active AI capabilities agreement. To upgrade from Unqork 9.0 or learn more, contact your Unqork representative.

Building a Smart Component

Prev Next

Every Smart Component is either Private or Public. A Private Smart Component is created inline in Module Builder and is single-use; it can only be placed in the module where it was created. A Public Smart Component is defined in the Smart Components Hub and can be placed in any module in the environment. Editing its definition propagates the change to every module using it.

This article covers creating and managing Public Smart Components through the Smart Components Hub.

Creating a Smart Component

To create a Smart Component, click LibraryBig Libraries in the global header, then select Puzzle Smart Components Hub. Select LayoutGrid Dashboard in the Explorer panel, then click + Create Component.

Enter the following in the creation dialog:

Field

Description

Type

The component type: UI, Logic, or Query. Read-only after creation.

Name

The display name for the component. This name displays in the component tray in the Module Builder once the component is Public.

Description

A brief description of what the component does. Optional.

The component opens in the Smart Component Editor immediately after creation.

Component Settings

After creation, access the component's settings from the EllipsisVertical (ellipsis) menu in the editor toolbar and select Settings Settings.

Field

Description

Type

The component type: UI, Logic, or Query. Read-only. The type is fixed at creation and cannot be changed.

Component Name

The display name for the component. Editable. Renaming does not affect the component's internal ID.

Category

The component tray section this component is grouped under in the Module Builder. Select from the fixed set of available categories. Clearing the field places the component under Uncategorized.

Description

A brief description of what the component does. Optional.

For Query Smart Components, the settings dialog also includes execution and role-based access controls. See Smart Component Settings.

Building in the Editor

The Smart Component Editor provides different views based on component type. For a full reference of views and controls, see Smart Component Editor.

Type

Available views

UI

UI View, Logic View

Logic

Logic View

Query

Logic View (read-only)

Click Save in the toolbar to save the component. Each save is recorded in the History area. Navigating away with unsaved changes displays a confirmation prompt.

Making a Component Public

A new Smart Component created from the Smart Components Hub is Private by default. Private components are available only in the module where they were created and do not display in the component tray.

To make a component Public, select Make Public from the component's row actions menu in the Smart Components Hub LayoutGrid Dashboard. Once Public, the component is available in the component tray in every module in the environment. This change is permanent. A Public component cannot be made Private again.

Editing a Smart Component

Private Smart Components can be edited inline in the Module Builder. Select the component on the canvas to open the Focused Component View.

Public Smart Components are edited in the Smart Component Editor. To open a Public component for editing from a module, select it on the canvas and select Edit Component in the Focused Component View toolbar. To open it directly, select it from the Smart Components Hub dashboard or from the Explorer panel.

Edits are saved into a draft. Select Review Changes in the editor toolbar to publish or discard the draft. When published, the change takes effect in every module using the component. See Smart Component Editor for full details.

Promoting to Another Environment

Smart Components are promoted to other environments directly from the Smart Components Hub. The Release Management Dashboard does not support Smart Components. Select Rocket Promote from the dashboard or from a component's row actions menu to open the promotion dialog.


Changelog

Date

Change

2026-09-10

Updated "Discoverable" → "Public" throughout; "Make Discoverable" → "Make Public"; corrected editing  for Private SCs (Focused Component View); updated views/areas table; "Open in Library" → "Edit Component" (EN-8038).

2026-09-03

Rewrote to distinguish Private vs Discoverable SCs; fixed "available in tray" claim (Discoverable only); corrected editing paths (Private=inline in MB, Discoverable=SC Hub); "Apply Edit" → "Review Changes"; "Logic Blocks/UI Blocks" → "Logic Smart Components/UI Smart Components"; removed body HR separators (EN-8038).

2026-08-13

Rewrote for rebuilt Smart Component Editor (EN-8017, UQE-16586): removed Interface view, Code/QLang, and Preview sections; updated navigation path; added Query type; updated editor structure and See Also links.

2026-08-10

Renamed Edit Base to Open in Library, documented Duplicate Component, and noted both live on the Properties panel (UQE-16875).

2026-07-01

Added Editing Smart Components section: Edit button for Private components, Add to Library promotion path, Edit Base for shared components in modules (UQE-16091).

2026-06-29

Initial draft — source reviewed from codebase; browser verify pending.