Webshop settings
List, add, edit, and delete your webshop's setting records by company and store.
The Webshop settings screen is where you view and manage the setting records that determine the operational behavior of your webshop (storefront). Each record consists of a name, a value, and the store it applies to; a record can apply to a single store or all stores of a company. Use this screen to control storefront settings such as payment, shipping, and catalog, to define a new setting, or to change an existing value. The screen is intended for administrators and e-commerce teams responsible for the store's technical configuration.
Accessing the screen
Follow the menu path Settings & Authorization › System › Webshop settings. If you do not see it in the menu, your account does not have permission for this screen.
The Add setting button and the edit and delete icons in the rows are visible only to accounts authorized to change webshop settings. If you do not see them, you can only view the settings.
Screen sections
- Page title Webshop settings with the description below: "Setting records in the selected company's store (webshop)."
- Filter area: Company (visible only if multiple companies exist), Setting name, Setting value, and Store fields; below them Clear and Filter buttons.
- Setting list: above it, Per page selector, Filter result: … records counter, Add setting button, refresh icon, and Columns menu; below it, pagination.
- Information note below the list: "Secret values (password, key, token) are masked and never match in value searches."
Filtering and searching
| Field | Purpose | Tip |
|---|---|---|
| Company | Selects which company's webshop settings to list. | Visible only if multiple companies exist in your workspace. When empty, Default company is shown and records of the first company are loaded. Changing the company and pressing Filter resets the Store filter because stores are company-specific. The Store list is then populated with the new company's stores only after this action. |
| Setting name | Searches records by name. | Setting names are saved in lowercase. |
| Setting value | Searches records by value. | Secret (masked) records never appear in value searches. |
| Store | Narrows records by the store they apply to. | Selecting All disables store filtering. The All stores option returns records valid for all stores of the company, not tied to a specific store. Other options are stores of the selected company. |
Filters are applied when you press the Filter button (or press Enter while in a field); if you have changed but not yet applied a filter, the Filter button is highlighted. If multiple fields are filled, records matching all criteria are listed. Clear empties all filter fields including company and immediately refreshes the list. Applied filters are preserved in the page URL; sharing the URL opens the same list.
List
| Column | Meaning |
|---|---|
| Setting name | The name of the setting. This column cannot be hidden. |
| Value | The setting's value. If empty, "—" is shown. Secret records show masked values with a yellow Secret label next to them. |
| Store | The store the record applies to. Records not tied to a specific store show All stores. |
- Use the Per page selector to show 25, 50, or 100 records per page; default is 25.
- You can hide or show the Value and Store columns via the Columns menu; your choice is remembered in this browser.
- Sorting by column headers is not supported.
- Clicking a row does not open a page; actions are performed via icons on the right side of the row.
- The refresh icon reloads the list without changing filters.
Actions
Every write operation on this screen is two-step: first you fill out the form, then a confirmation dialog appears summarizing what will be written. The confirmation shows Company, Store, Setting name, and (when saving) Value along with the warning: "This operation changes the live store's behavior. Store settings are read from cache; changes take effect when the store cache is refreshed."
Add setting
Used to define a setting not yet present in the store.
- Press the Add setting button above the list. A form titled Add setting opens; the description line shows which company you are writing to (Company: …).
- Enter the setting's name in the Setting name field. A note below reminds: "Name is saved in lowercase. The same name cannot be added twice for the same store."
- Enter the value in the Value field. Multiline values are allowed.
- Select the store where the setting applies in the Store field; leave as All stores if it applies to all stores.
- Press Continue. This button is disabled if Setting name is empty.
- In the Save this setting? confirmation dialog, verify the information and press Confirm and save.
If saving succeeds, a Saved notification appears, the form closes, and the list refreshes. If saving fails, the confirmation closes, an error notification appears, and the form remains open with your input; you can correct and press Continue again.
| Field | Required | Description / rule |
|---|---|---|
| Setting name | Yes | Maximum 400 characters. Leading and trailing spaces are trimmed. |
| Value | No | Up to 64 KB of text. |
| Store | No | Empty (All stores) or a store of the selected company. |
Edit setting
Used to change the name, value, or applicable store of an existing setting.
- Press the pencil (Edit) icon on the right of the relevant row. The Edit setting form opens with current data.
- Modify the necessary fields.
- Press Continue and in the Save this setting? dialog press Confirm and save.
Changing the store to All stores makes the setting valid for all stores of the company.
When editing secret records: The real value of a secret record never appears on screen; thus the Value field opens empty with the placeholder "New value (leave empty to keep unchanged)". A note below states: "This record's value is secret and never appears in the console. Leaving empty keeps the current value." Leaving the field empty causes the confirmation dialog to show (current value kept) instead of a value, and only name or store changes are saved. Entering a new value replaces the old one.
Delete setting
Used to remove a setting no longer in use.
- Press the trash bin (Delete) icon on the right of the relevant row.
- In the Delete this setting? confirmation dialog, verify the company, store, and setting name.
- Press Confirm and delete.
If deletion succeeds, a Setting deleted notification appears and the list refreshes. There is no undo; to reuse the same setting, you must define it again via Add setting.
If you press Cancel in the confirmation dialog, you return to the edit form without losing your input. Buttons become disabled during the operation and the confirm button shows Saving….
Common situations
- I saved but changes do not appear in the store. Store settings are read from cache; changes take effect when the store cache is refreshed. For cache refresh operations, see the Cache screen.
- "A setting already exists for this name and store" error. A record with the same name already exists for the selected store. Names are saved in lowercase, so names differing only in case are considered identical. Edit the existing record instead of creating a new one.
- "Setting could not be saved" error. The operation was rejected server-side. Provide the technical detail in the notification to your system administrator. This error may also occur if your account lacks write permissions.
- I cannot find a setting by value search. Secret records (passwords, keys, tokens) never match in value searches. Search by Setting name instead.
- The screen shows "Could not retrieve company and store list" or "Webshop settings service not configured." The screen failed to get company and store info or the webshop settings service is not defined for this setup. Reload the page later; if the problem persists, contact your system administrator.
- The screen shows "Something went wrong" instead of the list. Records failed to load. Press Retry; if the problem persists, provide the text in the Technical detail section to your system administrator.
- The list shows "No records found." No records match the selected filters. Change filters or clear all with Clear; verify the correct company is selected.