You are viewing docs on Elastic's new documentation system, currently in technical preview. For all other Elastic docs, visit

Search Page

Display products that match a customer's search query

The most important part of the search page is the relevance of the displayed results.

There are many ways to improve the relevance. In this article we'll cover:

  • tools available in the admin interface,
  • combining similar results with variants,
  • sorting — improved relevance achieved by a user.

Improving relevance

App Search offers many tools to improve the relevance of your search results.

Start with a language optimization

Choosing the correct language during the engine creation is the easiest way to improve the relevance.

Language optimization will fine-tune features like stemming, bigram matching, phrase matching, and typo tolerance for your chosen language.

Follow this guide for the exact steps: Language optimization guide.

Set up relevance tuning

App Search's relevance tuning feature allows you to fine-tune the order of the results for any given query.

Follow the Relevance tuning guide for the full feature description.

Add synonyms

This step is optional but can also improve the relevance.

Sometimes users will use a query that doesn't exactly match your results. You're selling couches, but a user searches for sofa? Tough luck!

To solve this problem, App Search offers a Synonyms feature. It lets you create groups of synonyms that will be used for matching.

Our Synonyms guide goes into more detail about the feature.

Create curations

Curations allow you to

  • promote some results to always show up at the top of the search results for a specific query
  • hide some results from showing up in the search results for a specific query

Learn more about curations in our Curations guide


You might have several products that are essentially the same but have one different attribute. For example, it could be shirts of different colors. In our demo, it's the same TV models but with different diagonal sizes.

If you have such products in your store, consider combining them into a single result. That will prevents users from being overwhelmed by the number of options.

Here's a demo of this feature:

To implement this in Search UI, you'll need to do the following:

  1. Enrich your dataset.
  2. Enable grouping in Search UI config.
  3. Add variants rendering into your Result component.

Enriching dataset

Add a new field to all documents in your dataset that will be used for grouping search results. Here's the example:

    "name": "Samsung TV 55 inch",
    "product_group": "[GROUP_ID_1]"
    "name": "Samsung TV 45 inch",
    "product_group": "[GROUP_ID_1]"
    "name": "LG TV 55 inch",
    "product_group": "[GROUP_ID_2]"

Make sure to add that new field to all the documents in a dataset! Otherwise, API will combine all the documents missing that field into a single group.

Enabling grouping in Search UI config

Search UI does not directly support the grouping, but it is supported by the underlying App Search API. So instead of enabling it in the Search UI config, we'll enable it in the App Search connector config. Here's an example:

const connector = new AppSearchAPIConnector({
  searchKey: "search-key",
  engineName: "engine-name",
  endpointBase: "endpointBase",
  // enabling grouping in App Search connector config
  beforeSearchCall: (existingSearchOptions, next) =>
      group: { field: "product_group", collapse: true }

export const config = {
  alwaysSearchOnInitialLoad: true,
  apiConnector: connector
  // other config properties

Adding variants rendering into your Result component

Once the grouping is enabled, the variants will be available via the _group field in your result document. Here's a simplified example of how to use it:

  result._group && result._group.length > 0 && (
      { => (
          <a href={variant.url.raw} target="_blank">
            <span dangerouslySetInnerHTML={{ __html: }} />


Adding sorting is simple — just use our <Sorting/> component, like so:

import { Sorting } from "@elastic/react-search-ui";

  label={"Sort by"}
      name: "Relevance",
      value: []
      name: "Price: Low to High",
      value: [{ field: "price", direction: "asc" }]
      name: "Price: High to Low",
      value: [{ field: "price", direction: "desc" }]

A good starting point for sorting options is to have these three:

  • Relevance / Featured / Best Match (usually the default option)
  • Price: Low to High
  • Price: High to Low

Consider adding some of these if they apply to your data:

  • Popularity
  • User rating
  • Distance (to the user)
  • Newest first

Check out how sorting is implemented in our demo:

Related Articles

Creating Components

Build your own components for Search UI

On this page