Smart Component Editor

The Smart Component Editor is where Creators write, preview, configure, and test Smart Components. The editor uses the same shell as the Module Builder and Workflow Builder: a toolbar, area tabs, and a content area. The areas and views available depend on the component type.

To open the Smart Component Editor, select Library in the global header, then select Smart Components Hub. Select a component from the Explorer panel, or use Open in Editor from the Hub's row actions menu, to open it in the editor.

Editor Layout

The Smart Component Editor has the following areas:

Area	Description
Toolbar	The top bar. Displays the component name, an unsaved changes indicator, the Save button, and the (ellipsis) actions menu.
View tabs	Below the toolbar. Switch between available views for the component. The tabs available depend on the component type.
Editing toolbar	Below the view tabs. Provides the Properties toggle, Viewport selector, and Highlight control for the active view.
Content area	The main editing surface. Displays the active view.

Editor Areas

The editor organizes content into three areas. Select an area in the area tabs to switch between them.

Views by Component Type

Within the Definition area, the views available depend on the component type.

UI Smart Components

Logic Smart Components

Query Smart Components

Editing Toolbar

The editing toolbar sits below the view tabs and provides controls for the active view.

Properties Panel

The Properties panel, available in the UI view, opens when Properties is selected in the editing toolbar and has two tabs.

If no inputs are defined in the component's interface, the Controls tab displays a prompt to define an input interface first.

Saving and Edit Mode

Shared Smart Components use a two-step publish model to protect all modules that use them.

• Save: Writes changes into a private draft buffer, not yet live in any module. Only one Creator can own the draft at a time.
• Review Changes: Opens the draft's review, where the draft is published or discarded. Previous versions are accessible in the History area if a rollback is needed.

Review Changes displays in the SC Editor toolbar when the Creator holds the draft. It opens a review of that one draft, which states where the component is used before either action is taken:

• Publish Changes: Publishes the draft as the live definition. The change takes effect immediately in every module using the component. If publishing leaves consuming modules holding settings the new definition no longer has, the review names those modules afterward so they can be fixed by hand.
• Discard Changes: Deletes the draft. The published version stays exactly as it is. Where discarding would also remove configuration that modules have set up against the draft, the review lists what goes and asks for confirmation first.

Publishing is withheld when another workspace's component builds on the draft, or when the component is used in modules outside the Creator's access. The review states the reason and offers the Component Library, where the draft can be duplicated instead. Discard stays available in every case, since it is the only way back out of draft mode.

Creators can also reach the same review without opening the editor: select Publish Draft from the component's row menu in the Component Library or the file explorer.

If another Creator opens the same component for editing while a draft is open, they can take over the draft. The new holder takes over from the current saved state of the draft. When this happens, the original holder receives a notification naming the new holder, their editor stops accepting saves, and Review Changes is withheld. Any unsaved changes stay on screen. To resume, take the draft back from the draft menu in the toolbar.

Review Changes is disabled when there are unsaved changes. Save first, then review.

Component Actions

Click the (ellipsis) in the toolbar to access the following actions.

Action	Location	Description
Make Discoverable	Toolbar button	Makes the component visible to the Build Agent across the environment and reusable in any module. Displays only while the component is private. This change is permanent. See Discoverability.
Accessibility Check	⋮ menu	Opens the accessibility checker for this component. Visible only when UnqorkAI is enabled in the environment.
Duplicate Component	⋮ menu	Creates a copy of this component in the library. Disabled while the Creator holds an open draft on this component.
Promote	⋮ menu	Opens the Promote dialog. Select a target environment and confirm to promote the component. Optionally include composed Smart Components as dependencies.
Export	⋮ menu	Downloads the component definition as an exportable file.
Settings	⋮ menu	Opens the component settings dialog. Rename the component, update its description, and set its category. For Query Smart Components, also configure execution behavior and role-based access controls. See Smart Component Settings.
Delete Component	⋮ menu	Permanently removes the component. This action cannot be undone.