Skip to content

Parameter definitions

The parameters your catalogue knows: type, unit, example values, and the context handed to the AI.

Available to roles Admin, EditorOpen in the app (Opens in a new tab)

This is the parameter list — the properties your catalogue knows about at all. Until a parameter is here, nothing can be mapped onto it, nothing can be filled in for it, and nothing can be filtered by it. It is the first step of normalisation.

Parameter definitions: a table of code, name, type, scope and unit for each parameter
Fig. 1 Parameter definitions. The code on the left is what appears in exports and the API; the name is what a person sees.

Controls on this screen

  1. Add parameterCreates a definition. The code is hard to change later — think it through.
  2. SearchBy name and by code. Indispensable at three hundred parameters.
  3. TypeFilter by data type.
  4. ScopeFilter by whether the parameter belongs to a product or a variant.
  5. Definition countHow many parameters the catalogue knows. It grows with every new vendor.
  6. CodeThe machine identifier. Used in exports, in the API and in templates.
  7. NameWhat a person sees in the catalogue and in the shop.
  8. TypeThe data type — text, number, yes/no, a choice from a list.
  9. Scope"product" = a property of the product; "variant" = it differs between variants.
  10. Unitmm, kg, W… A dash means a dimensionless parameter.
  11. Row actionsRecalculate values, export, edit and delete the definition.

What a definition holds

FieldWhat it doesNote
CodeThe parameter's machine identifier.Changing a code breaks the exports and templates that use it. Choose one that will last.
NameThe human name.This is what gets translated into the shop's languages.
TypeText, number, yes/no, or a choice from a list.A numeric type allows range filtering ("under 5 kg"); a text type does not.
ScopeDoes the parameter belong to the product, or does it differ between variants?Colour is usually per variant, packaging weight per product. A wrong scope only shows up in the shop, when the filter does not work.
Unitmm, kg, W and so on.Shown beside the value and used in conversions.
Example valuesA comma-separated list of expected values.Not a constraint — context.
Context for the AIAn explanation of what the parameter means.This is what decides the quality of AI extraction and AI mapping. A parameter called "BB Drop" tells the AI nothing without it.
Where did 300 parameters come from when I created none?

They appeared during imports — every new name a feed brought and that could be matched has a definition. With several vendors that is a few hundred quickly.

Can I delete a parameter?

Yes, but check first whether a template, an export or a shop filter uses it.

What is the difference between “product” and “variant”?

A variant-scoped parameter can hold a different value on every variant — typically colour or size. A product-scoped one has a single value for the whole product.