Site Search

Unbxd Site Search is an advanced product discovery tool which can be seamlessly integrated in your website, regardless of the platform - custom or hosted solution. Its wide range of features makes it a powerful search solution for your website.

In this section, you will learn in detail about the functionality of the different features of Unbxd Site Search which will help you while integrating.


For hosted solutions, like Magento, these features come in-built with the extension which readily available on their application store.


A simple query or q describes what is being searched for, on your eCommerce website. Our search server takes on an average 100 - 200 ms to respond to a particular query.

Handling Special Characters

In order to better understand visitor queries, Unbxd translates some commonly used special characters in a query such as, '+' ,'-' ,'&' ,'!', '(', ')', '*', '?', etc. For instance, you searched for suit(jacket+trouser+waistcoat) in the search box, Unbxd analyzes the query and shows results for three-piece suits. If these characters are not translated, they are realized differently by the Unbxd algorithm. For example, a query, "red dress" (typed within double quotes) will be considered as one single token and searched for in the search index.

Here is the complete list of special characters that we support:

'+',  '-' ,  '&',  '&',   '|',  '|',   '!',   '(',   ')',   '{',   '}',  '[',   ']',   '^',   '"',   '~',   '*',   '?',   ':',   '\'

If your are integrating via our SDKs, special characters are escaped automatically. However if you are using our APIs, you would need to manually escape them.

Query Redirect

The Query Redirect feature allows merchandisers help visitors find the non-catalog based information of your website such as the contact information, privacy policy, etc. right from your site's search box.
In other words, if you do not want a particular query to be looked up in the search index you can configure Redirects for such queries. This can be done from the Merchandising section of your Search Dashboard.


A visitor searched for site contact info from the Homepage. If a redirect had been configured for this query, the visitor will be taken to the Contact Us page of your website.

Redirect for any query can be easily configured from the Merchandising section of your Search Dashboard.


Pagination allows you to set the number of products you want to show your visitors in a per page. You would need to specify the page number and the number of products as the parameter or object values according to your implementation approach (API or SDK). You can display from 10 to 100 products per page.


Filtering allows you to apply filters on the desired fields which will help refine your search in order to reach the desired products faster. Irrespective of the approach, the filter field is always denoted with a suffix _fq, i.e. fieldname_fq.

There are two types of filters:

  • Text Filter
  • Range Filter
1. Text Filter

Text filter is used for filtering fields with string values such as, color, gender, brand, etc.,

2. Range Filter

This filter is used to filter products within a specific range. This is typically used on fields with decimal values like price, discounts, etc.


Faceting provides your visitors an interface to select desired field values (or product attributes or search listing page) in order to filter their search results.

To know more about how Unbxd powers facets in the Search API, please refer to the Facets documentation.


Sorting allows you to rearrange the search results based on certain fields in a particular order. Fields can be either sorted in numerical order or alphabetical order based on the field value. In other words, fields with decimal values can be sorted in either ascending (asc) or descending (desc) order. Fields with string values can be sorted from A-Z or Z-A. By default, Unbxd sorts your search results based on relevancy.


If you have not specified a sort parameter for your search results, Unbxd sorts it for you based on relevancy.


In case you have also configured sort rules for global queries through the dashboard. The search result would be sorted based on the rules configured in the API call and not on those configured via dashboard.

Sort can be applied on text, decimal, and integer.


You can configure more than one rules as a part of the default sort for global queries in your website. This can be done from your dashboard. An AND logical operator is used to cascade multiple sort rules which helps sort results in ascending or descending order.

How multi-sorting works?

Products will be sorted according to the order of the sort rules defined. Subsequent rules will be applied to only those products that have similar values for the field on which the first sort rule has been applied.

For example, you configured sort rules on price in ascending order, color in alphabetical (A-Z) order, and brand in alphabetical (A-Z) order. The search result will consist of:

  • Products with same price and color, sorted on brand in alphabetical (A-Z) order
  • Products with same price sorted on color in alphabetical (A-Z) order
  • Products sorted on price in ascending order

If you have configured slotting for global queries, those slotted products will undergo sorting in the same way and will rearrange themselves within the slots.

Bucketed Search

Bucketing lets you to group products based on similar product attributes such as category, brand, etc. into buckets.

How buckets are configured?

Buckets are configured for global queries on a specific product attribute, typically on categories. Once you have configured bucketing in your site, a query, if associated with bucket attribute, will return a bucketed search wherein each bucket will display products based on relevancy.

Buckets are usually configured on categories. This is how bucketed search looks like:


By default, a bucketed search will displays 10 bucket.


Banners are those elements in an ecommerce site that advertises or promotes a particular product attribute such as, brands, categories, offers, sale, etc. A banner acts as a filter i.e. when clicked on, lands your visitors to a search results page corresponding to the banner.

Although banners are a simple piece of HTML code, its contribution in increasing conversions in ecommerce websites is immense.

How banners are configured?

You can configure your banners for different category levels (catlevels) from your Unbxd dashboard.


Category level or Catlevel specifies the different levels or sub-levels of a category.

For example,Nike casual shirts will fall into these categories:

  • catlevel1: shirts
  • catlevel2: brand
  • catlevel3: occasion


If you want to configure banners for fields other than category, such as brand, discounts, etc., you can map those fields to the appropriate categories by performing a dimension mapping from your Unbxd dashboard.

Did You Mean? (Spell-check)

This feature provides spell suggestions or spell-check for misspelled search queries.

In such cases, Unbxd’s context-aware algorithm understands your visitor’s intent and redirects your visitors to a Did You Mean? page where relevant product are shown along with a query suggestion that matches with your feed data. This prevents your visitors to run into a zero-results page which might be an unpleasant experience for your visitors.

Our analytics records the frequency of similar misspelled queries and ranks suggestions accordingly.

SKU Search

SKU (or Stock Keeping Unit) is the unique identifier for a distinct product type. It is different from the UID (unique ID) as product variants (with distinct UIDs) have the same SKU ID indicating a particular product type. We support searches by the SKU IDs that is, you can search for a product by typing its SKU ID in the search box. This feature is useful if you have a large catalog size with wide-range of products e.g. online store for hardwares.

Ways to SKU Search

One way to search is by typing the entire string in the search textbox for example, you can find the product “Converse Chuck Taylor All Star II Shield Canvas High Top” by searching for its SKU ID “CCTAS2CHT777”. Another way is by typing only a part of the SKU ID string. From the above example, by searching for “CCTAS2” you can find “Converse Chuck Taylor All Star II Shield Canvas High Top” from the results along with other products with similar SKU ID part.

To enable this type of search, configure the schema of the “SKU” fields in your Product Feed with the “nsku” data type.


We do not support searches when the part of the SKU ID string typed in search text box, are not from the beginning. From the above example, searching for “TAS2” instead of “CCTAS2” will not yield results.