How can you add synonyms to a text search in Elasticsearch?

Adding synonyms to text search in Elasticsearch is an effective way to improve search quality, helping the system better understand user intent and return more relevant results. Below are detailed steps and examples:

Step 1: Define the Synonym File

First, create a synonym file containing all the synonym groups you want to define. For example, create a file named synonyms.txt with the following content:

shell
delicious, tasty
happy, joyful

Each line defines a group of synonyms, with words separated by commas.

Step 2: Update Index Settings

Next, reference this synonym file in your Elasticsearch index settings. Assuming your index is named products, update the index settings using the following command:

json
PUT /products
{
  "settings": {
    "analysis": {
      "filter": {
        "synonym_filter": {
          "type": "synonym",
          "synonyms_path": "analysis/synonyms.txt"
        }
      },
      "analyzer": {
        "synonym_analyzer": {
          "tokenizer": "whitespace",
          "filter": [
            "lowercase",
            "synonym_filter"
          ]
        }
      }
    }
  }
}

In this configuration, synonym_filter is a synonym filter using synonyms.txt, and synonym_analyzer is an analyzer that includes the whitespace tokenizer, lowercase filter, and the newly defined synonym_filter.

Step 3: Apply the Synonym Analyzer

Finally, ensure you use this synonym analyzer on specific fields in your documents. For example, to apply synonyms to the product description field description, configure it in the mapping as follows:

json
PUT /products/_mapping
{
  "properties": {
    "description": {
      "type": "text",
      "analyzer": "synonym_analyzer"
    }
  }
}

Example

Suppose you have a product with the description 'This apple is very delicious.' When a user searches for 'tasty apple', since 'delicious' and 'tasty' are defined as synonyms, Elasticsearch returns this product as a search result—even if the search terms do not match the product description exactly.

Conclusion

By following these steps, you can successfully add synonym support in Elasticsearch, improving search accuracy and user experience. This approach is particularly valuable in e-commerce, content retrieval, and other scenarios, making search functionality more powerful and flexible.