With rules you make sure your customers only put together configurations you can actually deliver. A rule checks a condition – for example “drive is solar” – and triggers an effect: it hides values or whole characteristics, pre-selects values or shows a message.
The principle
- Rule groups organise your rules, e.g. “Drive”, “Dimensions”, “Colours”. You create every new rule in a rule group.
- Every rule consists of a Condition (IF) and an effect that depends on the rule type.
- Rules are checked again with every selection. When the condition no longer applies, the effect ends too – a hidden value reappears.
Step by step
- Open the component and switch to the Rules tab on the left.
- Create a rule group with + next to Rules (Add rule group). Use the cog (Group settings) to give it a Group title.
- Click + (Add rule) on the group. The rule “New rule” of type Blacklist is created.
- On the right, under Rule settings, enter a Rule label and choose the rule type (field Validation type).
- In the middle, build the condition under Condition (IF) (see Conditions).
- On the right, define the effect – it differs per rule type (see Rule types).
- Save and test in the Preview. Like every change, a rule only applies in the shop after you publish.
Delete rule at the bottom of the rule settings removes a rule. Deleting a rule group removes all rules in it.
Rule types
| Rule type | Effect when the condition applies | Engine |
|---|---|---|
| Blacklist | Hides single values or whole characteristics | Legacy and V3 |
| Predefined values | Sets a specific value in a characteristic | Legacy and V3, with differences |
| Predefined qty | Sets the minimum and maximum quantity of a characteristic with quantity input | Legacy only |
| Predefined min/max | Changes the allowed range of an input field | Legacy only |
| Error / Warning | Shows the customer a message | Legacy and V3, with differences |
| Design (product designer) | Narrows what the customer may choose in a custom text or custom image, and presets it | V3 only |
What “Legacy” and “V3” mean is explained in Frontend Engine: Legacy or V3.
Blacklist
On the right you see all characteristics, sorted by group.
- Hide single values: expand a characteristic and tick the values that should no longer be selectable.
- Hide a whole characteristic: tick the box in front of the characteristic's name (Blacklist entire option). The characteristic disappears completely, including from the price and the summary.
Select all and Deselect all mark all entries of a group or a characteristic at once.
Block colours and fonts of a custom text (V3 only): For a characteristic of type Custom text on the product, the list also shows Block colours: and Block fonts: under the characteristic. Tick what should not be selectable under this condition, e.g. the colour White when the white mug is selected. These rows only appear when the characteristic has at least two colours or two fonts.
In the configurator:
- Blocked colour swatches and fonts disappear.
- As soon as at least one colour is blocked, the free colour picker disappears too.
- If a blocked colour or font is currently selected, the selection jumps to the first allowed one.
- If a rule would block all colours or all fonts, the list stays complete.
- The field shows the note “Not every colour, font or size is available for this choice.”
Legacy ignores this setting.
Whether blocked values disappear or stay visible greyed out is set for the whole component: Settings → General → Values excluded by rules = Hide (default) or Show disabled. With Show disabled, V3 also keeps fully blocked characteristics visible, greyed out. See Component Settings.
Predefined values
For each characteristic you choose a mode:
| Mode | When the value is set |
|---|---|
| Disabled | Never – the characteristic stays untouched (default) |
| Apply always | Always, even if the customer has already chosen something else |
| Only on default value | Only if nothing or the default value is selected |
| No selection or default value | Like Only on default value – and additionally when a blacklist has just hidden the previously selected value |
Then you choose the value to be set. The rule does not set a value that a blacklist is currently blocking.
Careful with the default value: If a rule with Only on default value or No selection or default value sets a different value than the characteristic's default value, the customer can no longer choose the default: as soon as they pick it, the rule sets its own value again. Make the preset value the default value, or block the default value under the same condition with a blacklist. The check on saving points this case out.
Dynamic value (Legacy only): instead of a fixed value, the rule takes the current value of another characteristic. For characteristics with values you define whether the match is made via the Value (Match by value) or the ID (Match by ID). V3 skips dynamic presets.
For input fields, V3 only pre-fills numbers, Legacy also text.
Predefined qty (Legacy only)
Applies to characteristics with Quantity enabled. You enter Min. quantity and Max. quantity. With Dynamic you take the limits from another characteristic. V3 ignores this rule type.
Predefined min/max (Legacy only)
Changes the allowed range of an input field, e.g. “with material wood at most 180 cm width”. For the characteristic you set Yes and enter the range as min-max, e.g. 40-180 (whole numbers). Input fields with an Allowed input are offered. V3 ignores this rule type – if your component runs with V3, limit dimensions with an Error / Warning rule instead.
Error / Warning
| Setting | Meaning |
|---|---|
| Error message | The text the customer sees. You can insert characteristics by their internal name, e.g. At most $max_width cm – the shop shows the current value there (for characteristics with values, the Value field). |
| Error type | Error or Warning |
| Execute when | When the message appears (Legacy only, see below) |
This is how the engines behave:
| Legacy | V3 | |
|---|---|---|
| Error | Appears as a dialog and prevents adding to the cart | Appears in red below the total price and prevents the cart and the action button as long as the condition applies |
| Warning | Appears as a dialog with Continue – the customer can still order | Appears in yellow below the total price – the customer can still order |
| Execute when | Direct after: as soon as the condition applies. Wizard: when clicking on from the step. Cart: when clicking add to cart. It is always checked at the cart. | Not evaluated – the message appears as soon as the condition applies |
| Characteristics in the message text | Are replaced | Are replaced |
Design (product designer)
V3 only, for characteristics of type Custom text on the product and Custom image on the product. While the condition holds, the rule narrows what the customer may choose there and can preset it. On the right there is a section for each of these characteristics. Whatever you leave empty, the rule does not change.
Custom text
| Setting | Meaning |
|---|---|
| Colours, Fonts | Tick entries and choose Hide the ticked ones or Offer only the ticked ones. |
| Palette from colour fields | While the condition holds, the colours come from the ticked text fields, e.g. Pantone fields that the customer fills in. See Colours from Pantone fields. |
| Colours & fonts from a building block | While the condition holds, the palette and, if it has any, the fonts of a Colours & fonts building block apply, e.g. the block “Foil colours” for Finish = Hot foil. Changes to the building block reach the rule too. If it is deleted, the rule keeps its last copy. See Building blocks. |
| Finish in the preview | While the condition holds, the preview shows this finish, e.g. Finish = Hot foil gold → Hot foil gold. If several rules match, the one with the higher Weight wins. |
| Min. size (mm), Max. size (mm), Max. lines, Max. characters | Limits that are tighter than on the characteristic. Wider limits than on the characteristic have no effect. |
| Preset | Colour, Font, Size (mm), Alignment and Vertical alignment. They replace a setting of the customer that the rule no longer allows. |
| The buyer may change | For Font, Size, Colour, Alignment and Position, each as set on the field, no (locked) or yes (unlocked). |
Custom image
| Setting | Meaning |
|---|---|
| Preset | Where a newly uploaded picture sits: Left (%) and Top (%) of the zone, measured from the top left, Size (%) (100 % is the size the zone gives) and Rotation (°). A picture that is already placed stays where it is. |
| Warn below (dpi), Refuse below (dpi) | Stricter resolution limits than on the characteristic, e.g. Refuse below (dpi) 300 for hot foil. Lower values than on the characteristic have no effect. |
| Only vector graphics (SVG), e.g. for screen print or hot foil | While the condition holds, only an SVG file is accepted, e.g. for hot foil. |
| Finish in the preview | While the condition holds, the preview shows this finish, e.g. Finish = Hot foil gold → Hot foil gold. If several rules match, the one with the higher Weight wins. |
| The buyer may change | For Position, Size, Rotation, Mirror and Crop, as for the custom text. |
In the configurator:
- Hidden colours and fonts disappear. While colours are restricted, the free colour picker is hidden as well.
- A rule never takes away every colour or font. If none would be left, the list stays complete.
- Whatever the customer has chosen and is still allowed stays. A colour or font that is no longer allowed switches to the preset, or without a preset to the first one still offered. The size moves into the new limits.
- If the rule locks something, that part returns to the rule's preset, or without a preset to the characteristic's setting. A custom image then sits centred at 100 % size, not rotated, mirrored or cropped.
- The custom text shows the note “Not every colour, font or size is available for this choice.”
- The restrictions also apply in the product image, in the image for the order, in the check before the cart and in the order data.
You can still block colours and fonts with a Blacklist as well (see above). Both rule types work together.
Conditions

You build the condition in the middle under Condition (IF):
- Choose the characteristic.
- Choose the comparison (operator).
- Choose the value or enter it.
+ Rule adds another row, + Group a subgroup. With and / or you decide whether all rows must apply or one is enough.
Operators
| Operator | Meaning | For |
|---|---|---|
| in | One of the given values is selected | all characteristics with values |
| not in | None of the given values is selected | all characteristics with values |
| is empty | Nothing selected or nothing entered | all |
| is not empty | Something selected or entered | all |
| = / ≠ | Equal / not equal | Input fields, calculations |
| < / ≤ / > / ≥ | Less, less or equal, greater, greater or equal | Numbers, e.g. width |
For characteristics with values (Select, Radio buttons, Checkbox, List with images …) the editor only offers in, not in, is empty and is not empty. You can give several values at once – the condition applies if one of them is selected. For Checkbox and Multi-selection it is enough if one of the ticked values is in your list.
What works as a condition
| Characteristic | Legacy | V3 |
|---|---|---|
| Select, Radio buttons, List with images | ✓ | ✓ |
| Checkbox, Multi-selection | ✓ | ✓ |
| Input fields (number, text) | ✓ | ✓ |
| Calculated characteristics (Formula, Price list, Combination) | ✓ | ✓ |
Subgroups: note for Legacy
V3 evaluates nested groups exactly as they appear in the editor. Legacy, however, always links a subgroup with and to the row directly before it – even if or is set outside – and cannot evaluate a subgroup in first position. For components with Legacy: never put a subgroup at the start and only combine it with and. If you need an or between groups, create two rules instead.
Legacy also treats the number 0 as empty for is empty.
When several rules meet
- Blacklists add up: everything that at least one applying rule hides is hidden.
- Chains: a characteristic that a rule hides and a blocked value don't trigger any further rules. Both engines re-evaluate until nothing changes any more. Legacy clears the selection of the hidden characteristic in the process; V3 remembers it and shows it again as soon as the rule no longer applies.
- Presets for the same characteristic: one rule wins.
- In V3 the Weight decides: the rule with the higher value wins. With equal weight, the rule further down the list wins.
- In Legacy the Weight is not evaluated. The order in the list applies.
- Messages are sorted by weight in V3, the heaviest first.
- Design rules for the same characteristic are merged: hidden colours and fonts add up, with Offer only the ticked ones what all matching rules offer remains, for limits the tighter value applies, and for the preset the rule with the higher Weight wins, with equal weight the one further down the list.
You set the Weight in the rule settings (default 0). Rules with a weight other than 0 show it as a badge in the list, e.g. +5.
Order
You change the order of rules and rule groups by dragging the handle ⠿ in the rule list. Rules outside groups are evaluated first, then the groups from top to bottom.
Test rules
- Save the component.
- Switch to Preview in the middle and click through typical and critical combinations.
- Check whether values disappear and reappear, presets apply and messages appear.
The preview runs with the configured frontend engine. If you switch the engine later, test the rules again – especially subgroups, presets and error messages.
Which rules affect a characteristic is shown in the characteristic on the right in the Referenced in tab. From there you jump straight to the rule.
Rules via the AI agent
You can also describe rules instead of clicking them: “If the material is wood, the colour RAL 7016 should not be selectable.” The AI agent creates the rule. Check it afterwards in the Rules tab and in the preview. More: AI Agent: Define Rules via Chat.
Practical examples
1. Colour doesn't match the drive Rule type Blacklist. Condition: Drive in Solar. Effect: tick the value White under Colour.
2. Accessory only with motor Rule type Blacklist. Condition: Drive in Crank. Effect: tick Blacklist entire option for the characteristic Remote control.
3. No white text on the white mug Rule type Blacklist. Condition: Mug in White. Effect: for the characteristic Your text, tick White under Block colours:. A second rule blocks Black when the black mug is selected.
4. Gold foil only in gold and short
Rule type Design (product designer). Condition: Finish in Gold foil. Effect: for the characteristic Your text, tick Gold under Colours and choose Offer only the ticked ones, tick the script fonts under Fonts and choose Hide the ticked ones, Max. characters 12.
5. Sensible pre-selection Rule type Predefined values. Condition: Model in Basic. Effect: Colour set to No selection or default value, value White. If the customer has already chosen their own colour, it is kept.
6. Size not available
Rule type Error / Warning. Condition: Material in Wood and Width > 180. Error type Error, Error message “Wood is available up to 180 cm width.”
7. Legacy only: limit the range
Rule type Predefined min/max. Condition: Material in Wood. Effect: Width set to Yes, range 40-180.
Troubleshooting
- The rule doesn't apply at all – check the operator: for characteristics with values you need in, not =. Also check whether the component is published; the shop shows the last published version.
- The rule only applies sometimes – is there a subgroup at the start, or is it linked with or? Legacy evaluates that differently (see Subgroups).
- Predefined qty or Predefined min/max has no effect – the component runs with V3, which doesn't know these rule types.
- Two presets contradict each other – set a Weight in V3; in Legacy change the order.
- The customer can order despite the message – check the Error type: only Error blocks the cart, a Warning only informs.
- A value jumps straight back to another one – usually it is the characteristic's default value, and a Predefined values rule with Only on default value or No selection or default value sets a different value. Make the preset value the characteristic's default value, or block the default value under the same condition (see Predefined values). The check on saving names the characteristic, the rule and both values.