docs.modx.pro
  1. Extras
  2. msBulkEditor
  3. Interface
  4. Presets

Presets ​

Save bulk operation parameters under a name for reuse.

Presets tab

Preset JSON form

Presets tab ​

An InfoBanner at the top explains: after save, use Apply or the toolbar menu.

ElementAction
NameUnique preset name
Preset JSONPayload as in products/preview / apply
SaveCreate or update by name
NewClear the form
Edit / LoadPut JSON and name into the form
ApplyOpen the operation dialog on Products
DeleteConfirm → toast

Confirm: delete preset

Empty list: empty state “No presets yet”.

Permission: msbulkeditor_presets. Without it the tab is hidden. Global presets (is_global) show a badge; only editable rows can be deleted.

Rename ​

  1. Load the preset into the form.
  2. Change Name (not the JSON).
  3. Save — UI creates the new name and deletes the old (presets/delete after save).

Form banner: “Renaming preset … After save the old name will be removed”.

JSON format ​

Minimal example (10% discount):

json
{
  "fieldType": "price",
  "parameters": {
    "field": "price",
    "mode": "percent",
    "sign": "-",
    "value": 10,
    "rounding": "integer",
    "transferToOldPrice": true,
    "variantScope": "product_only"
  }
}

Structure matches the preview/apply body without selection: launch uses the current Products selection.

How to build JSON:

  1. Start from the example above or a list payload (<pre>).
  2. Set fieldType and parameters from the fieldType reference / API.
  3. The operation dialog has no “Copy JSON” button.

Invalid JSON on save or apply → error toast.

Quick launch from toolbar ​

On Products → Presets menu (PresetMenu):

Menu stateBehavior
Loading“Loading…” item
Empty list“No presets” item
Has runnablePreset names; click → operation dialog

Requires selected products or expert mode (otherwise the menu button is disabled).

Presets menu on toolbar

Workflow ​

  1. Configure the operation on Products, verify preview.
  2. Build preset JSON.
  3. Save as “Discount −10% + old_price”.
  4. Later: filter → select → Apply in the list or from the toolbar menu.

A TV/option preset runs through the binding wizard.

Storage ​

Table msbe_presets, site-wide (not per-user). CRUD requires the presets permission.

See also ​