Smart Components Hub

The Smart Components Hub lists all Smart Components available in the environment. From here, Creators can browse components by type, view component details, open a component in the editor, and create new ones.

To open the Smart Components Hub, click Libraries in the global header, then select Smart Components Hub. Select Dashboard in the Explorer panel.

Public and Private

Every Smart Component is either Private or Public. This determines whether the component is reusable across modules and how the Build Agent uses it.

A new Smart Component is Private by default. A Private component can only be placed in one module, and only once in that module. Attempting to use it in a second module blocks the save; the platform prompts the Creator to create copies of the component instead. Copying a module that contains a Private component also copies its definition.

Selecting Make Public from the row actions menu makes the component available to the Build Agent and lets Creators add it to any module. This change is permanent. A Public component cannot be made Private again.

Editing a Public component propagates the change to every module that uses it immediately on publish.

Creators in Module Builder can view and configure a Public component's instance settings, but cannot edit the underlying definition. To edit the definition, open the component from the Smart Components Hub.

Making a container Public does not make its children Public. When a container Smart Component is made Public, only the container definition becomes Public. Any child components nested inside an instance remain independently Private or Public based on their own state. Parent and children are promoted separately.

Container Smart Components

Some Smart Components act as containers. They hold child components in typed slots instead of having fixed children built into their definition. Adding child components to a container instance and wiring them up requires the Build Agent. Drag-and-drop into a container Smart Component is not supported in 9.0.

Smart Components do not support composition. You cannot combine multiple existing Smart Components into a new Smart Component definition. A container can accept child components in typed slots, but those children are configured per instance and are not merged into the container's definition.

When the Build Agent updates a container definition, it analyzes whether the change is safe or potentially breaking for existing instances. Adding a new optional property is safe. Changing the type or structure of an existing property (for example, converting a text value to a child slot) might break existing instances, and the Build Agent surfaces this before proceeding.

Component List

The component list displays all Smart Components in the environment. Each row displays the following:

The Public and Private tabs display different columns.

Public tab columns:

The Public list sorts by Modules descending by default, placing the most-used components first.

Private tab columns:

The Private tab groups components by workspace in an expandable tree. Each workspace row expands to list its Private Smart Components. An Unassigned group displays at the bottom for Private components that have not been placed in any module yet.

Component Detail

Select any row in the component list to open the component detail dialog. The dialog displays the component's identity (name, type, and category), a Used In section listing every workspace, application, and module that uses the component in a hierarchy, and the component's interface in Inputs and Outputs rows.

The Used In section lists only modules that use this component directly. A module that reaches it through another Smart Component or through a module it imports is not listed.

Select View Details from the row actions menu to open the same dialog.

Component Actions

Select the ⋮ (ellipsis) on any component row, in the Hub or in the Explorer panel, to access the following actions.

Read Actions

These actions are available on every row a Creator can view.

Write Actions

These actions require specific permissions and are hidden when the Creator does not have the necessary grants.

Filtering

Select Public or Private above the list to switch between Public and Private components. Each tab shows a different layout: Public displays a flat list, Private displays a workspace tree.

Use the search box to filter by component name. Select the filter icon to the right of the search box to narrow results. The following filters are available:

Drafts and Publishing

Editing a Smart Component creates a draft. A draft is a private working copy of the component. Changes in the draft are not live until published. Only one Creator can own a draft at a time; the Draft owner column in the Public list shows who currently holds it.

While a draft is open, the component's row displays Publish Draft and Discard Draft in the (ellipsis) menu. Publish Draft pushes the changes live to every module using the component. Discard Draft removes the draft and restores the last published definition.

If another Creator opens the component while a draft is open, they can take over the draft. The original holder receives a notification and loses save access until the draft is returned.

When updating a Public Smart Component, prefer additive changes: add new optional properties with sensible defaults. Renaming, removing, or retyping existing properties breaks every module instance that relies on them. When a change cannot be made backward-compatible, duplicate the component and adapt the copy instead of modifying the shared definition.

For full details on the draft editing workflow, see Smart Component Editor.

Promoting Smart Components

Select Promote in the Library toolbar to open the Promote Smart Components dialog. Select a target environment, then select the components to promote individually or use Bulk Actions to select all. A confirmation step displays before the promotion runs.

If a selected component composes other Smart Components, a warning displays for any composed components not included in the selection. These warnings do not block promotion. Select the missing components to resolve them before confirming.

Promotion history is available in the dialog and displays all previous promote actions for the library.

Creating a Smart Component

Select + Create Component to create a new Smart Component. Enter a name, select a type (UI, Logic, Query, or Agentic), and confirm. The new component opens in the Smart Component Editor.