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 is grouped under in the Module Builder. Select from the fixed set of available categories. Clearing the field places the component under Uncategorized. |
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-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). |