Case insensitive term query – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 8.3-8.9

Briefly, this error occurs when you’re trying to perform a term query in Elasticsearch without considering the case sensitivity. Elasticsearch term queries are case sensitive by default. To resolve this issue, you can either convert your input and stored data to a common case (lower or upper) before indexing, or use a match query instead of a term query as it is not case sensitive. Alternatively, you can use a keyword analyzer or custom analyzer with a lowercase filter during indexing to ensure all data is stored in lowercase.

This guide will help you check for common problems that cause the log ” case insensitive term query ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: query, index.

Log Context

Log “case insensitive term query” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 throw new QueryShardException(context; fail("term query"));
 }  @Override
 public Query termQueryCaseInsensitive(Object value; @Nullable SearchExecutionContext context) {
 throw new QueryShardException(context; fail("case insensitive term query"));
 }  @Override
 public Query rangeQuery(
 Object lowerTerm;