Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Intelligent Search
Relevance
Merchandising rule conditions
Merchandising rule conditions

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 Manual Editor:
Trigger rules
Customization rules
contains
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 All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
department Selectable value that represents a department added to the store's catalog. is All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
brand Selectable value that represents a brand added to the store's catalog. is All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
productclusternames Selectable value that represents a collection added to the store's catalog. is All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
promotion Selectable value that validates if there is at least one promotion linked to the item (yes). is All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
sellername Selectable value that represents the name of a seller. is All editing scenarios
only Manual Editor:
Trigger rules

Visual Editor
subcategory Selectable value that represents a subcategory added to the store's catalog. is All editing scenarios
only 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 All editing scenarios
only 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. 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.
In other editing scenarios, it enables other conditions than the current one to also be applied. All (except for Term) 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.
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback