To configure a VTEX Intelligent Search merchandising rule using Visual Editor, follow the steps below.

1. In the VTEX Admin, go to Storefront, or type Storefront in the search bar at the top of the page.

2. Under Intelligent Search, click Merchandising Rules.

3. Click the + New button.

4. Complete the following fields:

   • Rule name: Merchandising rule name. Example: Promote product A when searching for a chocolate cookie.
   • Start date (optional): Set a date from which the merchandising rule will apply. The date follows the UTC-0 time zone.
   • End date (optional): Set a date when the merchandising rule will no longer apply to store searches. The date follows the UTC-0 time zone.
   • Apply to locales: Languages to which the merchandising rule will apply. The field is only available for stores using Multilanguage settings (Beta).

5. Click Visual Editor. Read the Types of editing section for more information about each editor.

6. Click Next.

7. Define at least one search term or filter for applying the merchandising rule:

   • To define a search term, type the term in the search bar (item II in the Actions available in the Visual Editor section).
   • To create a filter for applying the merchandising rule (item III in the Actions available in the Visual Editor section), follow the steps described in the Adding filters and conditions section.

8. You can also perform the following additional actions to customize the search results.

   • Define the number of items per row in the search results.

   • Define the number of items per page in the search results.

   • Hide products in the search results.

   • Pin products to the top positions of the search results.

   • Drag the pinned product to the desired position in the search results.

   • Edit the initial settings of the merchandising rule, including the rule name, start and end dates, and the locales to which it will be applied if the store uses the Multilanguage settings (Beta).

     Learn more about these actions in items IV, V, VI, VIII, IX, and XI of the Actions available in the Visual Editor section.

9. Click Save.

After saving, the changes to merchandising rules will take an average of two minutes to be updated.

The Visual Editor for merchandising rules in VTEX Intelligent Search allows you to perform the actions shown in the image below:

Filters are predefined selectable attributes that narrow the search results, such as filtering for all products in a category or brand, among other conditions. You can add one or more conditions to a filter.

To add a condition using the Visual Editor, follow the steps below.

1. Click Filter.
2. Click + Add condition.
3. Fill in the desired conditions. The available options are detailed in Merchandising rule conditions.
4. Click Save.

The defined conditions can work together (and) or alternatively (or).

In the menu of each existing condition, you can Duplicate or Delete the condition. To deactivate all created conditions, click Clear filters.