Skip to main content
How-to

StoreFront Search

Overview

Search lets shoppers find products on your StoreFront by typing a query instead of browsing your menus. You configure all of it from one screen, Main Menu → StoreFronts → (select your StoreFront host) → Search, which carries a tab for each part covered on this page: the primary search engine, up to three backup engines, faceted filters, and the advanced word handling that sits underneath them all.

Most stores need only the primary search settings. The rest of this page is there for stores whose catalog or vocabulary needs more tuning.

Configure search settings

The Search Settings tab controls the primary search engine: what it matches, how strictly, and which item fields carry the most weight.

FieldDefaultValid ValuesComments
EnabledOnOn/OffMaster switch for search. Uncheck to hide the search
Search Typefull textfull text, phraseIf full text, the entire text is searched for as a block. If phrase, then the individual words are searched for
Search Operatororor, andDetermines if the search returns back hits for any of the words found, or (if and is set), only returns back searches that contain all words
Search ModeNormal, Fuzzy, Wildcard(Both)These checkboxes are additive. If both normal and fuzzy are selected, results from both searchs are included.
Normal: includes a normal search. Normal means an exact match.
Fuzzy: includes a fuzzy search. Fuzzy means a close match.
Wildcard (Leading): The search is done with a wildcard in the front, so it would match words ending in the search string.
Wildcard (Trailing): The search is done with a wildcard in the rear, so it would match words starting with the search string.
Wildcard (Both): The search is done finding the search string anywhere within the searched fields.
Word DelimiterOnOn/OffIf set to on, spaces act as word delimiters
FieldsFields contains a table of all the searchable fields. This includes item fields and item attributes. Next to each field is a boost value to give a field a greater weight.

The StoreFront Search Settings tab, showing search type, operator, mode checkboxes, and the searchable fields table with boost values

tip

Test out your boost setting thoroughly. The defaults may give good results, or they may need tweaking. For reference, the highest boost the UltraCart staff has ever used is 1,000. For most stores, you will not need such high boosts to tweak your search properly.

The search settings screen carries four tabs with identical fields: Primary Search, Backup 1, Backup 2, and Backup 3. Each one is a separate search engine, and they run in order. If the primary search returns zero hits, Backup 1 runs, and so on down the chain. That lets each engine emphasize different criteria.

The primary search is almost always focused on store product, so it boosts fields such as item ID and is tuned to return the best product results. Backup 1 might instead be tuned to return the best company result, so a shopper searching for something about your company still gets useful results.

The StoreFront search settings screen with the Primary Search, Backup 1, Backup 2, and Backup 3 tabs

Most merchants use only the Primary Search. The backups fill a real need for merchants with diverse searching needs.

Example of a backup search configuration

In this example, a set of items containing a string in the item description was not being returned by the primary search, which emphasized the item ID. The backup search sets the search type to phrase and assigns the search field to Description with a full boost of 10.

A backup search configured with search type phrase and the Description field boosted to 10

Faceted search lets shoppers narrow results by applying several filters at once, rather than working through a single fixed ordering. Each item is classified along multiple dimensions, called facets, so a shopper can combine them to reach the exact set of products they want.

This matters most for large catalogs of similar products. A store selling tens of thousands of remote controlled vehicles and accessories can offer filters that let a shopper land on the handful of items meeting all of their criteria.

A StoreFront product listing with faceted search filters down the left side, narrowing a large catalog of similar products

To turn it on, go to Main Menu → StoreFronts → (select your StoreFront host) → Search, then open the Faceted Search Results tab and enable the filters you want to offer.

The Faceted Search Results tab with checkboxes for enabling individual search facet filters

warning

Click the save button after making your configuration changes. Enabled filters are not applied to your StoreFront until you save.

Advanced search features

The advanced features give finer control over how a query is interpreted before it is matched:

  1. Scrub incoming search terms using a regular expression filter to restrict what words are allowed. The syntax follows the Java programming language.
  2. Add stop words. Encountering these words in the search algorithm will cause a stop in that search path.
  3. Add synonyms. These are used to replace one word with another to help search results.

The advanced search features screen with fields for the regular expression filter, stop words, and synonyms

Blog posts are included in Page Search results alongside your other StoreFront pages. How that indexing works is not currently documented.

  • StoreFront Menus covers the navigation shoppers use when they browse instead of search.
  • StoreFronts Sitemaps locations covers submitting your pages to external search engines, which is separate from the search box on your own StoreFront.
Was this page helpful?