The Smart Component Settings dialog is where Creators configure a component's name and description. For Query Smart Components, it also includes execution settings and role-based access controls.
Settings can be opened from the following locations:
In the Smart Components Hub, select the
(ellipsis) on a component row and select Settings.In the Smart Component Editor, select the
(ellipsis) in the editor toolbar and select Settings.
Component Details
The Component Details section is available for all Smart Component types.
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 this component. Editable. The internal component ID is fixed at creation and is not affected by renaming. |
Description | A brief description of what the component does. Optional. |
Category | The component tray section this component displays under when promoted to Public. Available categories: Primary Fields, Secondary Fields, Display & Layout, Data & Event Processing, Charts & Graphs, Agentic Pallet, and Queries. Public components without a category display under Uncategorized in the tray. |
Component-Level RBAC
Component-level RBAC permissions can be configured on Smart Components from the module canvas. Write and No Access work identically to Centauri components. Read Only and Obfuscate have no effect on the rendered UI.
Permission | UI Behavior | Data and Submission Behavior |
|---|---|---|
Write | Visible and interactable. | Values save to the submission. |
No Access | Not displayed. | No data is written. |
Read Only | No UI change. | Values are not written to the submission on save. |
Obfuscate | No UI change. | Values are masked as |
Read Only and Obfuscate have no UI effect because Smart Components are dynamic and can contain multiple form fields. The runtime cannot determine the expected visual state for the component as a whole. Creators who need Read Only or Obfuscate behavior must implement it in the Smart Component definition. Add a setting that controls the state, then write the logic to apply the visual behavior when that setting is active.
Execution Settings
The Execution Settings section is available for Query Smart Components only. It controls how and by whom the query can be executed at runtime.
Backend Execution Only
Setting | Description |
|---|---|
Backend Execution Only | When set to ON, this setting restricts the query to server-side execution only. Front-end modules that attempt to call the query will receive a 403 Forbidden response. Use this setting when the query accesses sensitive data that must not be exposed to the client. |
Role Permissions
The Role Permissions section controls which Express roles can execute this query at runtime. Roles set to No Access and roles not in the permissions table both default to denied execution.
The table lists all Express roles in the current environment. For each role, select Execute to grant access or No Access to deny it.
If no Express roles are configured in the environment, the permissions table does not display.
Changelog
Date | Change |
|---|---|
2026-09-18 | Added Component-Level RBAC section — documents Write, No Access, Read Only, and Obfuscate behavior; Read Only and Obfuscate have no UI effect on SCs (EN-8132). |
2026-09-15 | Expanded Category description — lists valid categories, clarifies tray grouping and Uncategorized behavior for Public components (EN-8101). |
2026-09-03 | Removed body HR separators; fixed See Also paths; corrected Role Permissions: "Read" → "Execute"; replaced "select to add" drop-down description with accurate table-of-all-roles behavior (EN-8038). |
2026-08-13 | Added Category field to Component Details (EN-8006, PR #8367). |
2026-08-11 | Initial publication (EN-7975). Documents Component Details and Execution Settings (backendExecutionOnly, role permissions) for Query Smart Components (UQE-16405). |