Skip to content

Settings

Menu: Commerce -> Settings
Deep link: /_Admin/commerce/settings?SiteId={siteGuid}

Site-level commerce global configuration (Commerce Store settings): units of measure, checkout payment methods, product/category/order field models, and variant/digital product display rules. After save, affects product types, product management, product categories, orders, etc.; scripts read via k.commerce.settings, see k.commerce settings.

vs "Currencies" menu

Storefront default currency code / symbol is usually maintained under Commerce -> Currencies; this page Basic section currently has weight unit and payment methods (if currency dropdown appears later, follow actual admin UI).

How to Open

  1. In the Edit menu, enable Commerce -> Settings (and the parent Commerce group).
  2. Open Commerce -> Settings in the left sidebar.

Page Structure

Single-page form, three white cards top to bottom + bottom fixed Save (KBottomBar, no Cancel). Keyboard shortcut save supported (same as other site edit pages).

Commerce settings: basic, custom fields, display toggles
SectionContent
BasicWeight unit, enabled payment methods
Custom fieldsProduct fields, category fields, order extension fields
Display togglesHide attributes / hide variants / digital product delivery required (conditional)

Basic

ItemDescription
Weight unitkg or g; used for variant weight and shipping freight calculation
Enabled payment methodsMulti-select dropdown; options from installed payment modules (configure payment in service integrations /_Admin/system/config, see k.payment). Saved as payments array; checkout shows enabled only. Tooltip: configures k.commerce.settings.payments

Custom Fields

Three SortableList lists, structure similar to Content -> Content Types field table, but data writes to commerce settings not content types.

Commerce settings: product, category, order extension field lists

Product Fields

Controls product detail form and product management list summary columns.

ActionDescription
AddOpens custom field dialog for new field
EditChange type, display name, validation, summary column, etc.
DeleteNon-system fields deletable; system fields (Title, Images, etc.) cannot be deleted
SortDrag to reorder fields

Tooltip: Summary fields appear on the list page.

Category Fields

Controls product categories edit page and list dynamic columns; same rules as product fields.

Order Extension Fields

Adds extension data definitions for orders; field types geared to orders (e.g. filterable, exportable, column width, etc.); dialog differs slightly from product/category custom field dialog.

Custom Field Dialog (product / category)

Click Add or row Edit on product or category field list opens CustomFieldDialog.

Custom field dialog: basic, advanced, validation tabs

Common configuration (same control types as content field editor):

Tab / ItemDescription
BasicName, display name, control type (text, rich text, image, select, etc.), multivalue, summary field, multilingual, etc.
AdvancedDynamic options, content folder relation, etc. (per control type)
ValidationRequired, length rules, etc.
System fields Images / ImageAllow editing image meta template (product featured/category image metadata)

After saving dialog, field enters corresponding list; must click page bottom Save to write to site.

Display Toggles

Commerce settings: hide attributes, hide variants, digital delivery required
ToggleDescription
Hide attributesWhen on, product types create dialog and list Attributes column hidden; product detail basic info hides Attributes key-value pairs
Hide variantsWhen on, products treated as single variant; no variant options / variants on type and detail; list hides variant count
Digital product content cannot be emptyShown only when at least one product type has Digital product checked; when on, saving digital product requires each variant to configure digital product delivery