In this section · 14 articles

How the settings hub works

Every installation setting lives in one Settings hub, split into panels. Learn how to move between panels, who can see or change each one, and how saving works.

Applies to
Core 12.0 and later
Who can do this
Administrator, Platform owner
On this page

In short

All of Laramin's installation settings open in one place, the Settings hub. It is split into panels such as System, Company and Theme. Each panel has its own pair of permissions, one to view it and one to change it. You save one panel at a time.

How it works

Getting to a panel

The sidebar entries under Configurations › General Settings, such as System Settings or Company Settings, all open the same hub, on the panel you chose. The panel's address is /admin/settings/<panel>, for example /admin/settings/company, on an installation that keeps the standard /admin path.

Inside the hub, a list on the left shows every panel you may open, under group headings:

GroupPanels covered in this category
GeneralSystem, Company, Theme, Cookies, Maintenance, Uploads, Maps, Help Center
SecurityPublic website

The same list also holds panels covered elsewhere, such as CAPTCHA, GDPR, security and developer settings. If you can't open any panel, the hub says You do not have access to any settings.

The Settings hub, with its panel list on the left under the General, Security and Developer headings, and the Company panel open showing the Identity and Location sections.

Who can see and change a panel

Each panel has two permissions, in the pattern feature.core.<panel>.view and feature.core.<panel>.edit. In the role editor they appear under General Settings or Security Settings as, for example, View System and Edit System.

PanelPermission name
Systemfeature.core.system.*
Companyfeature.core.company.*
Themefeature.core.theme.*
Cookiesfeature.core.cookies.*
Maintenancefeature.core.maintenance_mode.*
Uploadsfeature.core.uploads.*
Mapsfeature.core.maps.*
Public websitefeature.core.home_page.*
Help Centerfeature.core.help_portal.*. Super admins only: it's left out of the Administrator role. See Connect your installation to the Help Center.

With view but not edit, the panel opens with You have read-only access to this panel. and you can't save.

Saving

Change the fields you need, then select Save changes. You see Settings saved. To throw away what you've typed since you opened the panel, select Reset changes.

Each field has an info tooltip that explains it. If a value isn't accepted, the field says why and nothing on the panel is saved.

Some panels ask you to confirm before they save, or tell you afterwards what the save changed. A few also list what stopped a save, under This can't be done right now.

Secret values

A field that holds a secret, such as the Google Maps API Key, never shows the stored value. It shows •••••••• — leave blank to keep. Leave it blank to keep the current value, type a new one to replace it, or select Clear to remove it when you save.

The Maps settings panel, where the Google Maps API Key field shows •••••••• — leave blank to keep instead of the stored key, with a Clear button beside it.

Settings a workspace can change for itself

Most settings apply to the whole installation. A few belong to a business, so each workspace can override them:

  • On Company: every field except Social Links.
  • On System: Default Currency and Default Language.

A workspace's overrides are set on that workspace's own settings page, not in the hub. To reach it, open Users Accounts › Workspaces and select Settings on the workspace's row.

Settings on System and Company apply to the whole installation. A workspace's own settings page can override Default Currency, Default Language and every Company field except Social Links.

How it relates to

Next steps