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 rules
Merchandising rules

Merchandising rules allow you to modify search results to prioritize and return more relevant products to customers based on custom criteria. Thus, you can customize the products listed in the search, tailoring the results to your sales strategies.

You can use these rules to promote specific products based on user behavior by setting trigger rules, such as terms searched or filters applied.

Merchandising rules can promote, demote, add, or remove items from search results when triggered. To determine the items that will be affected, you can choose products, brands, categories, sellers, or other criteria.

You can configure merchandising rules for different use cases. See some examples in the table below:

ActionExamples
Promote items
  • Defines greater relevance to the products of a specific brand. Example: When the customer searches for "smartphone," the products of this brand will be displayed at the beginning of the listing, followed by those from other brands.
  • Promote a specific product. Example: When the customer searches for "running t-shirt," the product "Running T-shirt" will be the first result displayed in the search results. Increase the relevance of products with linked promotions.
Add items
  • Display complementary products. Example: When searching for "laptop," add related accessories such as "laptop backpack" and "wireless mouse" to the search results.
Demote items
  • Demote products from a category or collection that is not highlighted at a specific time. Example: During the summer, decrease the relevance of winter items, such as "wool coats" in searches for "coat".
Remove items
  • Remove a specific product from search results. Delete a category that is not relevant to a specific customer segment. Example: Searching for "men's fashion" will remove women's fashion products from the results.

How it works

Merchandising rules are a priority configuration. So, if you create a rule to promote a specific product for a particular search, this product will be at the top of the results, regardless of the other Relevance settings.

What determines in which cases to apply a merchandising rule are the trigger rules, which are the set of conditions that identify the scenarios where the action will be triggered.

Best practices

Some of the main examples of the use of merchandising rules are:

  • Promote a specific product for a particular search.
  • Adjust the order of the products in the list. Example: A clothing store that wants to display search results in a specific order, like a window display.
  • Remove products from the list but keep them directly accessible from the product details page. Example: A pharmacy that needs to hide antibiotics from search results but keep them available on the product details page.

Consider the following recommendations for using merchandising rules in your store:

  • Manage merchandising rules based on Intelligent Search's relevance rules and synonyms. Make sure that these three are aligned to avoid conflicts and provide a cohesive and efficient search experience.
  • Don't use merchandising rules with opposite effects for the same items, as this can lead to unexpected behavior in search results.
  • If too many merchandising rules are created, then the organic search will probably be greatly affected.
  • Be careful when using global trigger rules, as they impact all searches.

If the search results are not correct, we recommend not creating merchandising rules to fix them, as this could indicate some other configuration problem. In this case, please contact our Support.

Learn more

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