Merchandising rule conditions

3 min read

In the Manual Editor and the Visual Editor (beta), the merchandising rule conditions follow the {criterion} {operator} {value} format. For example, a condition may be brand is athletic, in which brand corresponds to the criterion, is to the operator, and athletic to the value.

Learn about the criteria and possible operators for each type of editing in the following tables:

Criteria

Name	Description	Operators	Types of editing
`Term`	Word searched by the customer that will be related to the rule. Open input field.	- `is` - `contains`	Manual Editor: - Trigger rules - Customization rules
`ID`	Searches for the exact ID of a catalog element related to the rule. Possible IDs are: ProductID, ProductRefID, SKUID, SKURefID, and EAN. Open input field.	`is`	Manual Editor: - Customization rules
`category`	Selectable value that represents a category added to the store's catalog.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`department`	Selectable value that represents a department added to the store's catalog.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`brand`	Selectable value that represents a brand added to the store's catalog.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`productclusternames`	Selectable value that represents a collection added to the store's catalog.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`promotion`	Selectable value that validates if there is at least one promotion linked to the item (`yes`).	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`sellername`	Selectable value that represents the name of a seller.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`subcategory`	Selectable value that represents a subcategory added to the store's catalog.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor
`{{specification}}`	Any active catalog specification checked as Filter appears as a custom criterion, with the same possible values. The name of the criterion is exactly the name of the added specification. For example, if there is an active specification called `Color`, the displayed criterion is `Color`. You cannot create rules with specifications that were not checked as Filter. Learn more about this field in Adding product specifications or fields or Adding SKU specifications or fields.	- `is` - `only`	- All editing scenarios Manual Editor: - Trigger rules Visual Editor

The department, category, and subcategory criteria only appear as options to be included in Merchandising Rules if all three category levels are previously configured in the Catalog.

Operators

Name	Description	Criteria	Example
`is`	- If you create a rule in the Manual Editor using `Term` as a criterion, it will return search results with exact words. - In other editing scenarios, it enables other conditions than the current one to also be applied.	- `Term` - All (except for `Term`)	- If you add `black friday` and a customer searches for `black friday`, the merchandising rule is triggered. However, if the customer searches for `black friday promotion`, the rule will not be triggered. - If the condition is brand is `athletic`, even if the customer selects `hotsport`, `sportist`, and `athletic` in the search, the merchandising rule will be triggered.
`contains`	When creating a rule in the Manual Editor using `Term` as a criterion, it generates search results that are not limited to exact words.	`Term`	If you add `black friday` and a customer searches for `black friday` or similar expressions such as `black friday promotion`, the merchandising rule will be triggered.
`only`	Limits the filter to the one that you added.	All (except for `Term`)	If the condition is brand is `athletic`, and the customer selects `hotsport` first in the search, even if they select `athletic` later, the merchandising rule will not be triggered. It will only work if the first brand filter selected is `athletic`.