Product Parameters
Parameters are named product specs — for example "Material: cotton", "Country of origin: Italy" or "Volume: 500 ml". They let a customer see a product's technical details at a glance, and they can also be used as a filter on the storefront, exactly like attributes, labels and tags.
Path: Admin > Products > Parameters
Parameters vs. attributes
Attributes define a product's variants (Color, Size) and determine which version of the product the customer buys. Parameters are informational specs — they don't change the variant or the price, they just describe the product. Both can be used as a filter.
What parameters are
A parameter is a name + values pair. Examples:
- Material — values: cotton, polyester, wool, leather
- Country of origin — values: Slovakia, Italy, Germany
- Volume — values: 250, 500, 1000
- Packaging color — values: red, blue, green (Colour type)
Each parameter has a type that determines how its values are entered and how they render when the parameter is used as a filter.
Creating a parameter
Path: Admin > Products > Parameters — open the Create parameter form with the button at the top of the page.
| Field | Description |
|---|---|
| Parameter Type | List or Colour (see below) |
| Parameter name | The name the customer sees (e.g. "Material"). Entered per language using the language tabs |
| Predefined values | The list of the parameter's values. Each value is entered per language. Add values with Add value and remove them with Remove |
Once filled in, save the parameter. In the list, each parameter appears as a card with its name and a preview of its values; Colour parameters also carry a Colour badge.
Parameter Type
List
The default type. Values are plain text (e.g. "cotton", "polyester"). Suitable for most specs — 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 render as coloured squares instead of text.
For the Colour type, each value gives you:
| Element | Description |
|---|---|
| Swatch colour | A colour picker or a hex code in #RRGGBB format |
| Auto-detect colours | A button that tries to fill in colours for the values based on their name (e.g. "Blue" → a blue shade). It recognizes colour names from the store's colour palette in all languages |
Colour swatches require the Checkbox display type
Colour swatches only show when the filter uses the Checkbox display type. If you use a Colour parameter in a filter with a different display type, the values render as text. That's why, when you build a filter from a colour parameter, the display type is automatically set to Checkbox.
Parameters as a filter
Parameters can be used as a filter source on the storefront — exactly like attributes, labels and tags. In Filters, the Quick Create tool shows parameters as a separate source group called Parameters.
- Text parameters (List type) work as a classic filter with value selection (multi-select, checkbox, dropdown).
- Colour parameters (Colour type) render values as colour swatches — but only with the Checkbox display type.
- Numeric parameters (parameters whose values are all numbers) can use a range slider (from–to), just like numeric attributes and price.
How to turn a parameter into a filter
Go to Admin > Products > Filters, in the Quick Create tool pick a parameter from the Parameters source group and set the display type. See Product Filters for details.
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 the parameters to your products when editing them.
- Optionally build filters from the parameters so customers can filter products by them.