Utilities: Product fields

Configure fields on the Data tab in the product card.

Cookbook

Sections, hiding fields, extra fields link: Product fields cookbook. End-to-end example: Wholesale price.

Purpose

This utility controls layout on the Data tab:

• field visibility and order
• section groups
• labels and widget xtypes

Create new columns in ms3_product_data via Extra fields. After POST extra field, a row appears here automatically.

Interface

Sections

The left panel lists sections with drag-and-drop sorting.

Section actions:

• Add — create a new section
• Edit — change section parameters
• Delete — delete a section (fields move to "No section")
• Drag — reorder sections

Fields

The right panel shows fields for the selected section.

Displayed info:

• Field name (key)
• Label
• Widget type (xtype)
• Visibility status

Field actions:

• Edit — configure field parameters
• Drag — reorder within the section

Section management

Creating a section

1. Click Add section
2. Fill the form:

Field	Description	Required
Section key	Unique identifier (Latin)	Yes
Lexicon key	Key for translated title	No
Title	Display name	No
Hidden	Section hidden in product card	No

Lexicon

If a lexicon key is set, the title comes from localization files. This supports multiple manager languages automatically.

Editing a section

Click the edit icon next to the section name or double-click the section.

Deleting a section

Note

When a section is deleted, all its fields move to "No section". Fields are not deleted.

Field management

Editing a field

Click a field to open the edit dialog.

Available parameters:

Parameter	Description
Title (label)	Display label
Description	Hint below the field
Section	Section the field belongs to
Widget type (xtype)	Form element type
Visibility	Show/hide in product card
Order	Position in the section field list

Widget types (xtype)

Type	Description
textfield	Single-line text
numberfield	Number field
textarea	Multiline text
xcheckbox	Checkbox
ms3-combo-vendor	Vendor picker
ms3-combo-autocomplete	Autocomplete from list
ms3-combo-options	Pick from product options

Moving fields

Fields can be moved:

• Within a section — drag up/down
• Between sections — change section in the edit dialog

Default sections

By default these sections exist:

Key	Title	Description
main	Main data	SKU, price, weight, etc.
availability	Availability	Stock, flags
content	Content	Description, attributes

Saving changes

• Changes save automatically when dragging
• When editing a field/section click Save
• Reload the product page to see changes in the product card

API endpoints

Get field configuration

GET /api/mgr/config/page-fields/product_data

Response:

{
  "success": true,
  "object": {
    "fields": [
      {
        "name": "article",
        "label": "SKU",
        "xtype": "textfield",
        "section": 1,
        "visible": true,
        "sort_order": 0
      }
    ]
  }
}

Get sections

GET /api/mgr/config/sections/product_data

Save field configuration

PUT /api/mgr/config/page-fields/product_data

Write permission: mssetting_save. GET works for any manager session without mssetting_save.

Request body — a fields array (not a single field):

{
  "fields": [
    {
      "name": "article",
      "label": "Product SKU",
      "section": 1,
      "visible": true,
      "sort_order": 0
    }
  ]
}

Save sections

The UI adds a section locally, then saves the full list:

PUT /api/mgr/config/sections/product_data

{
  "sections": [
    {
      "section_key": "custom",
      "lexicon_key": "ms3_section_custom",
      "label": "Additional",
      "hidden": false,
      "sort_order": 100
    }
  ]
}

Delete section

DELETE /api/mgr/config/sections/product_data/{section_key}

Base sections cannot be deleted. There is no POST /config/sections/... in 1.13.x.

Configuration examples

Hiding unneeded fields

For a clothing store using options for color and size separately:

1. Open field color
2. Uncheck Visibility
3. Save
4. Repeat for size

Creating an "SEO" section

1. Click "Add section"
2. Fill:
   • Key: seo
   • Title: SEO
3. Move metatitle, metadescription into the new section

Section order

Drag sections to the desired order. For example:

1. Main data
2. Prices
3. Availability
4. SEO