Product Parameters
Parameters are named product properties (specifications) — for example "Material: cotton", "Country of origin: Italy" or "Volume: 500 ml". They let customers see the technical details of a product at a glance, and they can also be used as a filter in the store, just like attributes, labels or tags.
Path: Catalog › Products › Parameters
Parameters vs. attributes
Attributes define product variants (Color, Size) and decide which version of the product the customer buys. Parameters are informational specifications — they do not change the variant or the price, they only describe the product. Both can be used as a filter.
What parameters are
A parameter is a pair of name + values. Examples:
- Material — values: cotton, polyester, wool, leather
- Country of origin — values: Slovakia, Italy, Germany
- Volume — values: 250, 500, 1000
- Packaging colour — values: red, blue, green (type Colour)
Each parameter has a type that decides how its values are entered and how they are shown when you use the parameter as a filter.
Creating a parameter
Path: Catalog › Products › Parameters › Create Parameter button
The Create Parameter button in the page header opens a dialog with the form.
| Field | Description |
|---|---|
| Parameter Name | The name the customer sees (e.g. "Material"). Entered separately for each language using the language tabs |
| Parameter Type | List or Colour (see below) |
| Predefined Values | The list of the parameter's values. You enter each value for each language. Add values with Add Value and remove them with Remove |
A value you no longer want to offer does not have to be deleted — Deactivate value (hides it on the storefront, assignments stay) hides it while products keep it. If you remove a value that products use, the dialog offers Deactivate instead or Remove anyway. With a long list of values, the search (Search values…) and the All / Active / Inactive switch help.
When you are done, save the parameter. In the list each parameter has a row with its name and a preview of its values; Colour-type parameters also carry a Colour badge. Edit a parameter by clicking its name or through the ⋯ menu › Edit; the same menu also has Delete.
Parameter type
List
The default type. Values are plain text (e.g. "cotton", "polyester"). Suitable for most specifications — material, country of origin, brand, volume and so on.
Colour
A special type where each value is tied to a specific colour swatch. When you use the parameter as a filter, the values are shown as coloured squares instead of text.
With the Colour type each value has:
| Element | Description |
|---|---|
| Swatch colour | A colour picker or a hex code in the #RRGGBB format |
| Auto-detect colours | A button that tries to fill in colours for the values based on their names (e.g. "Blue" → a blue shade). Colour names from the store's colour palette are recognized in all languages |
Colour swatches need the Checkbox display
Colour swatches are only shown when the filter uses the Checkbox display type. If you use a Colour-type parameter in a filter with another display type, the values are shown as text. That is why creating a filter from a colour parameter sets the display type to Checkbox automatically.
Parameters as a filter
Parameters can be used as a filter source in the store — exactly like attributes, labels and tags. In the Quick Create tool in Filters, parameters appear as a separate Parameters source group.
- Text parameters (type List) work as a classic filter with a choice of values (multi select, checkboxes, dropdown).
- Colour parameters (type Colour) show their values as colour swatches — but only with the Checkbox display type.
- Numeric parameters (parameters whose values are all numbers) can use the range slider (from–to), just like numeric attributes and price.
How to make a filter from a parameter
Go to Catalog › Products › Filters › All Filters, choose the parameter from the Parameters group in the Quick Create tool and set the display type. Details in Product Filters.
Workflow
- In Parameters, create the parameters you need and enter their values.
- For colour parameters, set the type to Colour and assign colours to the values (or use Auto-detect colours).
- Assign parameters to products when editing them.
- Optionally create filters from the parameters so customers can filter products by them.