Important
You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.
See our Release Process documentation for more information on the currently supported and upcoming releases.
Search Functions Concept Guide
A search function on your website provides a seamless experience for your visitors. Giving customers the ability to find the information they are looking for quickly is a key ingredient for creating a user-friendly website.
Your website may have a vast database with numerous pages and information, making it harder for users to locate the required information. With this in mind, Oro has developed a helpful search utility to help customers query that database and find the material quickly.
Note
See a short demo on how OroCommerce’s advanced search features can enhance the B2B ecommerce experience for both sellers and buyers.
You can find the search bar:
in the header and menu of the storefront
in the header of the back-office and in its system configuration menu
To find a record through the search bar, start typing the search key into the text field and select the most relevant suggestion from the dropdown list.
Several out-of-the-box functions enhance the effectiveness and speed of the search functionality.
Storefront-specific
Global Search Boost - The feature works with the searchable product attributes only. It is available in the OroCommerce Enterprise edition. It influences the relevancy ranking of your search results in the storefront and helps pull the necessary attribute to the top of the search result list. By default, the boost for SKU is set to 5, for names to 3, meaning that the searchable word is first searched among SKUs, then names, etc. The bigger the number, the higher the relevancy. With Search Boost, you can configure any search behavior required for your business, which allows you to have better control over search results.
Search Autocomplete - The intuitive feature generates predictions based on searches that you start to type. It shows up-to-date product information, such as SKU, name, price, and inventory status. You can set the number of products and product categories to be displayed in the storefront search result dropdown on the global, organization, and website levels.
Partial Product Search - is a dynamic feature that allows customers to locate products through the global search and on the quick order form by simply inputting a fragment of the product name or description. With this feature, users can efficiently find products even when they only have a portion of the product’s name or description in mind. This can significantly improve the user experience, streamlining the process of product discovery and selection. You can toggle the option on the global, organization, and website levels.
Automatic Phrase Suggestions - The intuitive feature generates suggested phrases as users type their search queries. By presenting users with these automatic suggestions, the feature helps guide them towards more accurate and relevant search results, reducing the likelihood of misspellings or ambiguous queries. You can also provide the number of suggested phrases to users. You can configure the option on the global, organization, and website levels.
Saved Search - The feature is available in the OroCommerce Enterprise edition. It enables customer users to save their search queries, view these saved search queries under the Saved Searches menu in the customer user account. You can also configure the registered customers to receive notifications when a new product falls under the search conditions and when products from the search query result are back in stock. The configuration is available on the global, organization, and website levels.
Fuzzy Search in the Storefront - The feature is available in the OroCommerce Enterprise edition. Fuzzy searches help you find relevant results even when the search terms are misspelled. When enabled, it searches for the text that matches the term closely instead of exactly. You can set the number of errors in each word the application can ignore or set a threshold for the error-tolerant search usage. The configuration is available on the global and website levels.
Search Synonyms in the Storefront - The feature is available in the OroCommerce Enterprise edition. You can create a group of synonyms so that when a user searches for a word from this group in the OroCommerce storefront, the system would return results for all the synonyms in this group. Synonym management can be enabled globally and per website in the system configuration, and subsequently managed through Marketing > Search > Search Synonyms in the main menu.
Search History - If the feature is enabled, you can view a history of all searches performed by a customer user in the storefront under Marketing > Search > Search History. The grid includes information on all keywords entered by a user, the search result type (product autocomplete, product search, or empty), the number of products found (if applicable), the date and time of the search, the website where the search was performed, the localization used when the search was performed, and the name of the customer and customer user who performed the search (if applicable).
The option also enables a Search Terms report that shows how frequently a specific search phrase was used, and whether the search query returned an empty result.
The feature can be configured on all levels: globally, per organization, website, customer group, and customer.
Stop Words - Provide a list of stop words that you want to be ignored by the search engine in the OroCommerce storefront to improve the quality of the search results. The feature can be configured globally and per website.
Back-office-specific
Search by an entity in the back-office - When searching for a term in the back-office, the feature enables you to select the entity that most likely contains the searching record. The search result will then display the records that belong to this entity first.
Search by tag in the back-office - The feature enables you to view all the records with a specific tag anywhere in the system. Select the Tag entity when searching for a term and click the tag when found. You will be presented with a page that looks similar to the search results and contains all the records with this tag.
Quick Search - The intelligent search feature is located in the configuration panel on the left (on all configuration levels). It helps you locate the specific configuration option instantly by keywords. It narrows down the query when you start typing the key letters and displays real-time search results.
Fuzzy Search in the Back-Office - The feature is available in the OroCommerce Enterprise edition. It works similarly to the storefront fuzzy search functionality but searches for the misspelled terms in the back-office. The configuration is only available globally.