All Collections
Advanced Help
Search Products
Search Tools and How Search Works
Search Tools and How Search Works

Your guide to search tools and how search works in EvolutionX. Includes catalog containers, popularity, search recipe, priorities, and sort.

Séamus Diamond avatar
Written by Séamus Diamond
Updated over a week ago

It's easy to tune search in a way that improves your results but it can also have unintended consequences.  When changing search settings it's good to work slowly.  Make a change, test it, and keep it for a while before making more changes.  

We have our Best Practice Checklist that we'd highly recommend you review! There are lots of ways to influence search and this gives you a way to tune in a positive way.

Guide to Search Tools

This is our top level guide but you can find more about each topic in the titled sections below.

  • Make changes slowly, test them, let them sit for a while to see the affect for users before making more changes.

    • Automatic value based on store add-to-cart records

  • Global Container Search Priority – In your Catalog Container avoid setting all of your catalogs to different Search Priorities.  It works best when you use the same value within only a few groupings (two groups is ideal).  Assume you have 6 managed catalogs in your global catalog container and you think of them in two groups, four of your catalogs are the high priority ones and two the low priority ones.  When setting Catalog container Search Priorities use value 1 for all of your high priority catalogs and priority 2 for all of your low priority catalogs (or set them all to 1 if they are equal).  Catalogs→Catalog Containers→Catalog Assignment

  • Item Priority – If enabled in Store Preferences, the items in the result will first be ordered using the item priority value and the remaining are based on relavance (by search score). Read more here about setting Item Priority and how it works.

  • Product Search Sort – In the Admin→Settings→Store Preferences→Product Display you will find the Product Category Sort and Product Search Sort settings. This sets the default sort when a category or search results loads.

    • Sort by Relevance 👍 — this orders items based on the combination of terms searched and popularity boost, if configured.

    • Sort by Popularity — this is not recommended as default since it sorts only by the popularity score.

How Search results and Category views Works

Items to Display

  1. Check for Customer Alias and Search Assist — if an exact match is found, it's substituted

  2. Product Availability — checks the product records for active status, active dates, and visibility status (visible, hidden, private)

  3. Catalog Container Visibility Rules — determines items to display and removes duplicates

    1. If configured, also removes deactivated brands and zero cost items.

Order to Display (Search pages and Category pages)

  1. Distributor Sort — Dealer can control the sort of items returned

    1. Order by In-stock Items first — if Prioritise in stock items enable then items are grouped by in-stock, then out-of-stock

    2. Order by Product Priority — items by item priority, if enabled, are promoted first

    3. Order by Container Search Priority (Used for Search only, not category views)— Keeps the search order the same but groups the results by the search priority in the display, starting with the lowest priority integer.

    4. Order by brand priority — if brand priority is selected

    5. Product listed in ordered of Relevance Score — items returned by the search engine are in order of the relevance score (including key words found and popularity as described above).

  2. User Sort — User can override the order of items in the display by selecting a sort order other than relevance.

Search Logic and Steps

EvolutionX Search Processing Steps

User enters a search term e.g. "red pen"

  1. Customer product alias codes ( if they exist )

    1. Exact match only

  2. We look for a matching Search Assists

    1. Match on the most specific

      1. We find the longest search assist term that is found within the search term and then return the associated alias.

  3. We query the full index with the following

    1. We query using search assist alias, customer product alias codes, or just the search term.

    2. Apply Store Search recipe when querying the full index.

      1. Popularity boost will influence the recipe and thus the results returned

  4. We take the first 1,500 results from the above steps and we scrub them based on the following.

    1. Rules :

      1. Deduplicate based on Catalog priority within the catalog container

        1. We deduplicate products between catalogs by one of the following SKU, Product ID, or Manufacturer ID

        2. We ignore priorities "0"

      2. We apply rules (e.g. Inclusion or exclusion)

      3. We priorities based on "Container Search Priority"

      4. Brand deactivation

      5. Priorities In stock items (if set)

        1. We split the records into 2 batches, in stock vs out of stock and then apply your chosen Product Search Sort / Category Product Sort setting (e.g. brand priority) separately each set.

      6. We apply Product Search Sort / Category Product Sort (e.g. relevance, brand priority, product priority, etc)

        1. We only apply the one selected. For example, if you have brand priority selected then we sort the results with brand priority first and not popularity.

      7. Apply Product Visibility rules

  5. Finally, return results to the customer.

Did this answer your question?