Synonym set synonymsSetId not found – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 8.9-8.9

Briefly, this error occurs when Elasticsearch is unable to locate a specified set of synonyms. Synonyms are used in Elasticsearch to expand or contract the scope of a search. The error indicates that the synonym set with the given ID does not exist. To resolve this issue, you can either create a new synonym set with the specified ID or correct the ID in your query if it was mistyped. Also, ensure that the synonym set is correctly defined and loaded in the appropriate Elasticsearch index.

This guide will help you check for common problems that cause the log ” Synonym set [” + synonymsSetId + “] not found ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: .

Log Context

Log “Synonym set [” + synonymsSetId + “] not found” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 .setQuery(QueryBuilders.termQuery(SYNONYMS_SET_FIELD; synonymsSetId))
 .execute(new DelegatingIndexNotFoundActionListener<>(synonymsSetId; listener; (l; searchResponse) -> {
 if (searchResponse.getHits().getTotalHits().value == 0) {
 l.onFailure(new ResourceNotFoundException("Synonym set [" + synonymsSetId + "] not found"));


How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?