{"section":"tutorials","requestedLocale":"en","requestedSlug":"search-behavior","locale":"en","slug":"search-behavior","path":"docs/en/tutorials/intelligent-search/intelligent-search-behavior/search-behavior.md","branch":"main","content":"The Search Engine is the core of VTEX Intelligent Search's intelligence. It interprets the search term and displays a filtered and ordered list of products. This tool allows a more objective search through indexing and treatment of the catalog data.\n\nThis feature is included by default in VTEX Intelligent Search and covers the vast majority of scenarios. However, you can also adjust the Search Engine to improve search results. This guide covers the following:\n\n* [Standard search behavior](#standard-search-behavior)\n* [Search behavior configuration](#search-behavior-configuration)\n* [Alternative ways to search](#alternative-ways-to-search)\n\n## Standard search behavior\n\nThe following are characteristics of Intelligent Search's standard behavior.\n\n### Autocorrect\n\nUsers can make spelling mistakes when searching. The tool interprets these misspellings and shows similar products.\n\nThe search engine performs an automatic correction for each search based on the items added to the catalog. For each search term, a specific number of wrong characters is allowed. The number of accepted misspellings is called _fuzzy_.\n\nThe _fuzzy_ varies depending on the length of the search term. By default, if the term is 3 to 5 characters long, the _fuzzy_ applied will be 1, which means that 1 misspelled character is allowed. For terms of 6 characters or more, the _fuzzy_ applied will be 2.\n\nThe predicted misspellings considering *fuzzy* = 1 are:\n\n* Add 1 more character.\n* Remove 1 character.\n* Change 1 character.\n* Swap 2 characters that are next to each other.\n\nExample: Suppose a customer wants to search for the term `ball`. Using the default configuration (*fuzzy* = 1 for terms of 3 to 5 characters), the search engine will return results for `ball` in any search that contains accepted errors, such as:\n\n* `bawll` (add 1 more character)\n* `bal` (remove 1 character)\n* `balk` (change 1 character)\n* `abll` (swap 2 characters next to each other)\n\n> ℹ️ Blank spaces are not considered in *fuzzy*, so `base ball` will not be corrected to `baseball`. We recommend using [synonyms](/en/docs/tutorials/synonyms) for such cases.\n\n### Minimum result\n\nThe minimum number of results displayed for any search is 1. If a search does not meet this minimum, [autocorrect](#autocorrect) is applied.\n\nIn a search with multiple terms, the following logic occurs:\n\n1. If the minimum result is not reached even after the initial autocorrect, the search starts to include more comprehensive results containing any of the search terms. For example, if a user searches for \"nike sneakers\" and the catalog doesn't have any products matching that name, the search will return products with only the term \"sneakers\" instead.\n2. If the comprehensive search doesn't return the minimum result, the process will be repeated, applying autocorrect again to each term.\n\n> ⚠️ Searches with multiple terms are more efficient when customers sort the results by relevance, as such sorting can return more results than the initial search context. When sorted by relevance, items with multiple terms are prioritized. However, with other sorting criteria, such as price or bestsellers, the result ranking is based on these numerical values and does not necessarily prioritize items that match more search terms.\n\n### Pagination limit\n\nVTEX Intelligent Search limits the search results to 50 pages, which encourages the customer to use filters, creating a more relevant and focused experience.\n\n## Search behavior configuration\n\nThere is a set of settings that change the products that are displayed in search results and their order. In the following sections, you will see the main definitions that affect search behavior.\n\n### Defining searchable fields\n\nDetermines which product information is searchable. From this configuration, every search in the search bar checks the content of these fields to generate search results. Check the following table to understand which information is searchable by default and the other configuration options:\n\n| Information | Configuration |\n| - | - |\n|
Product name
Brand
Product ID (`ProductID`)
Product reference code (`ProductRefID`)
SKU ID (`SKUID`)
SKU reference code (`SKURefID`)
EAN
| Information that is searchable by default in VTEX Intelligent Search. To remove any of this information, please contact our [Support](https://supporticket.vtex.com/support). |\n|
Product specifications
SKU specifications
Department
Category
Subcategory
| To include the desired specifications as searchable fields, you must configure the **Searchable specifications** option in the VTEX Admin, under **Intelligent Search > Search Settings**.
For example, if a shirt doesn't have the color in the product name or SKU, by default, Intelligent Search won't identify this attribute in a search for \"blue shirt\", displaying shirts of different colors as results. However, if the color specification is configured as searchable, the search will likely return blue shirts at the top of search results.
For more details about defining searchable specifications, check out the [Search configuration](/en/docs/tutorials/search-configuration#general-settings) guide. Learn more about specifications in [Product and SKU specifications](/en/docs/tracks/specifications-concept-definition). |\n| Manufacturer code (`ManufactureID`) | Please contact our [Support](https://supporticket.vtex.com/support) to set these fields as searchable. |\n\nFor example: The \"color\" specification is set as searchable and the product was added with the name \"Nike Total 90 Sneakers\" and the color \"black\". If a customer searches for \"Black Sneakers\", the tool will return products that have the term \"sneakers\" and the color \"black\" at the top of search results.\n\nYou can include special characters ( `-` and `/`) when searching for a product.\n\n> ⚠️ Choosing the search fields affects the [merchandising rule](/en/docs/tutorials/merchandising-rules) options, as only searchable fields can be used to set up the rules. For example, if you set only the **`SKUID`** field as searchable, you cannot promote a**` ProductID`** or a **`ProductRefID`** using merchandising rules. \n\n### Defining and sorting filter fields\n\nIn all search results, users can select filters. Some filters are pre-defined by default, but it is also possible to create more filters to meet store needs. The display order is also customizable. Example: In a search results list, there can be filters for Price, Categories, and Brand.\n\n### Configuring relevance\n\nRelevance is the ordering principle of search results. In this section, you can assign weights and prioritize certain criteria in the Search Engine, such as popularity, release date, and promotions. The relevance of a product is composed by the combination of weights and priorities defined by each merchant.\n\n_For example_: a merchant configured that \"promotion\" has greater relevance than other criteria. When a customer searches for \"t-shirt\", the tool might display the t-shirts on sale at the top of search results, depending on the weights assigned to other criteria.\n\nFor more information on how to customize the order of results to meet your store's needs, read the article [Relevance settings](/en/docs/tutorials/relevance-rules).\n\n> ℹ️ When using Intelligent Search, two options define the sorting order of your collections. By using the `map=productClusterIds` command, you are setting the order of your collections to be the one pre-defined by the merchant, with its relevance criteria. If you choose to use `productClusterNames`, you are setting that you want your collections to follow Intelligent Search's own relevance standards.\n\n## Alternative ways to search\n\nIt is possible to search by the ID of one or more items in the search bar or by adding search parameters (*query*) in the store URL.\n\n### Partial match\n\nBy entering the exact first digits of the product ID (`ProductID`), product reference code (`ProductRefID`), SKU ID (`SKUID`), SKU reference code (`SKURefID`), or EAN in the search bar, Intelligent Search will partially match products and SKUs active in the store, adding them to the search results.\n\nFor example, if the product ID is `123456789` and you search for `123`, it will be listed in the search results. However, the product will not be displayed if the search is `234` and does not include any of the first ID numbers.\n\n### URL\n\nTo search from your store URL, add search parameters (*query*) at the end of the store URL, respecting one of the following structures:\n\n- Example for searching an item: `[account address]/[id type]:[id_1]?q=[id type]&map=ft`\n- Example for searching a list: `[account address]/[id type]:[id_1];[id_2];[id_3]?q=[id type]:[id_1];[id_2];[id_3]&map=ft`\n\nThe possible value types for the ID type field are `product.id`, `sku.id`,`sku.ean`, `sku.reference`, or `id` (ProductID, ProductRefID, SKUID, SKURefID, and EAN). All searched IDs should be of the same type. \n\n- **Search by SKU ID:** `?q=sku.id:` or `?q=sku:`\n- **Search by EAN:** `?q=sku.ean:`\n- **Search by reference ID:** `?q=sku.reference:`\n- **Search by slug:** `?q=product.link:`\n- **Search by product ID:** `?q=product:` or `?q=product.id:`"}