Help CenterHelp Center / Discounts and marketing · Reference
What each message in the rule builder means and which field to correct.
When a rule cannot be saved, the builder shows "Please fix the highlighted fields." with a list. The live Preview shows the same messages in a red box while you type. Some messages name an internal field; this page translates them.
| Message | Field to correct |
|---|---|
| "This type needs config.tiers (a non-empty list)." | Fill at least one tier row |
| "Each tier needs a min and a value (numbers of at least 0)." (min_qty for volume pricing) | A tier row has From or Value missing |
| "Buy X get Y needs config.buy.qty and config.get.qty of at least 1." | Both Quantity fields |
| "A bundle needs config.price (at least 0)." | Bundle price |
| "A bundle needs config.qty (at least 1) or config.items." | Number of items, or the product rows of a fixed set |
| "A free gift needs config.item_id: a product of your shop." | Gift product |
| "config.quantity must be at least 1." | Quantity of the gift |
| "A loyalty multiplier needs config.multiplier above 1 and at most 100." | Points multiplier |
| "A payment method offer needs conditions.payment_methods…" | Tick a method under Paying with |
A percentage Value above 100 is refused as well.
| Message | Field to correct |
|---|---|
| "targeting.product_ids must list at least one id for this scope." (also category_ids, brand_ids) | Pick at least one item for the chosen scope, or choose Every product |
| "… contains ids that are not in your shop." | A picked product, category or brand no longer exists. Remove it |
| "Choose active locations of your shop." | A newly chosen location is switched off |
| Message | Field to correct |
|---|---|
| "The end must be after the start." | Ends |
| "schedule.windows must be a list of …" | A happy-hour row has only one time. Fill both or clear both |
| Message | Field to correct |
|---|---|
| "The code may only contain letters, digits, - and _ (3 to 64 characters)." | Code |
| "A coupon already uses this code." / "Another discount rule already uses this code." / "A bulk discount code already uses this code." | Code: one code belongs to one offer |
| "This rule uses bulk codes: it cannot also have its own code." | Leave Code empty |
| Message | Field to correct |
|---|---|
| "Tick at least one offer this rule combines with, or choose "Every other offer". To combine with nothing, set Stacking to Exclusive." | Only with… has nothing ticked |
| "Each language's text may be at most N characters." | Badge text (60) or description (500) |
| "Use a JPG, PNG or WebP image of at most 5 MB." | The banner image |
| Message | Meaning |
|---|---|
| "An archived rule cannot be activated here: edit its status." | Open Edit and change Status |
| "The full offer engine … is not included in your plan, so your discount rules are paused." | Creating, editing, activating and generating codes need the offer engine. See Discount engine modes |
The yellow box in the preview, and Check before you save on a saved rule, list possible conflicts with other rules. They do not stop you from saving. See Priority and combining.
For messages customers see at checkout, go to Troubleshooting.