System Settings
System Settings is the platform-wide control panel where system administrators enable or disable optional tenant-facing features and select operational modes that change how microservices and menu customization work across every tenant. Each setting is stored centrally and applied to all tenants immediately; there is no per-tenant override. Use this page to roll out or roll back features that should be uniform across the platform.
Accessing the Page
Section titled “Accessing the Page”- Route:
/system-settings - Menu Path: Settings → System Settings
- Primary audience: System administrators only. Accessed via the system admin login at
system.portal.net— not the tenant portal. Non-system users do not see the menu entry and any direct navigation is blocked by the access guard.
What you can do here
Section titled “What you can do here”- Disable optional tenant-facing features (Custom Fields, System Templates, Tenant API Keys) platform-wide.
- Switch microservice access between per-tenant grants and a global “all active services for all tenants” mode.
- Switch menu customization between per-tenant overrides and a single system-default tree applied to every tenant.
Common tasks
Section titled “Common tasks”- Open Settings → System Settings at
system.portal.net. - Toggle a feature in Feature Access to disable it across the platform. The change takes effect immediately and the corresponding menu entries disappear for tenant users on their next navigation.
- Change Microservice Access Mode to All active services for all tenants to bypass per-tenant grant management — every active microservice becomes available to every tenant automatically.
- Change Menu Customization Mode to System tenant default to manage a single menu layout from the system tenant that applies to all tenants.
- Save is not required — changes persist as you toggle them.
Settings reference
Section titled “Settings reference”| Key | Type | Default | Effect when disabled / changed |
|---|---|---|---|
Custom Fields (custom_fields_enabled) | Toggle | On | Hides Custom Fields administration page and blocks write endpoints for non-system-admin users. Read endpoints remain accessible so existing forms keep rendering custom values. |
System Templates (system_templates_enabled) | Toggle | On | Hides the System Templates page and blocks email-template endpoints for non-system-admin users. |
Tenant API Keys (api_keys_enabled) | Toggle | On | Hides Tenant API Keys management and blocks the related endpoints for non-system-admin users. |
Microservice Access Mode (microservices_access_mode) | Select | Per tenant | Per tenant — each tenant is granted access to specific microservices via the Tenants → Micro-Service Access tab. All active services for all tenants — the per-tenant grant table is bypassed and every active microservice is exposed to every tenant; the per-tenant Micro-Services tab is hidden from the tenant edit page. |
Menu Customization Mode (menu_customization_mode) | Select | Per tenant | Per tenant — each tenant administrator can reorder/hide menu items for their tenant. System tenant default — the menu layout is managed centrally from the system tenant and applied to every tenant; tenant admins see a read-only Menu Layout page. |
- Settings are cached server-side for a short period. Toggle changes invalidate the cache immediately, but external CDNs or browser caches may take longer to reflect downstream visibility changes.
- System administrators are not affected by Feature Access toggles — they retain access to Custom Fields, System Templates, and Tenant API Keys administration regardless of the toggle state, so they can re-enable a feature even if it was disabled.
- Switching Microservice Access Mode from Per tenant to All active services for all tenants does not delete the existing per-tenant grants — they are simply ignored while the global mode is active. Switching back restores the prior grants.
- Switching Menu Customization Mode between modes does not delete the existing overrides — per-tenant overrides are preserved while the system-default mode is active and re-applied when switching back.
- This page is only available in multi-tenant deployments. In single-tenant mode the page is not registered.
Related Pages
Section titled “Related Pages”- Tenant Management — per-tenant settings, including the Strict User Mode toggle and the Micro-Service Access tab (hidden when the global mode is selected here).
- Micro-Services — the platform service registry; service availability depends on the Microservice Access Mode chosen here.
- Menu Layout — tenant-side page; its read/write behavior depends on the Menu Customization Mode chosen here.