Unknown parameter in Include Exclude clause – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 7.16-8.9

Briefly, this error occurs when an unrecognized parameter is used in the Include/Exclude clause of an Elasticsearch query. This could be due to a typo, incorrect syntax, or using a parameter that is not supported in the current version of Elasticsearch. To resolve this issue, you should first verify the parameter name and syntax. If the error persists, check the Elasticsearch documentation for the version you are using to ensure the parameter is supported. If the parameter is not supported, you will need to find an alternative way to achieve your desired result.

This guide will help you check for common problems that cause the log ” Unknown parameter in Include/Exclude clause: ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: search, aggregations.

Log Context

Log “Unknown parameter in Include/Exclude clause:” class name is IncludeExclude.java. We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 } else if (NUM_PARTITIONS_FIELD.match(currentFieldName; parser.getDeprecationHandler())) {
 numPartitions = parser.intValue();
 } else if (PARTITION_FIELD.match(currentFieldName; parser.getDeprecationHandler())) {
 partition = parser.intValue();
 } else {
 throw new ElasticsearchParseException("Unknown parameter in Include/Exclude clause: " + currentFieldName);
 if (partition == null) {
 throw new IllegalArgumentException(
 "Missing [" + PARTITION_FIELD.getPreferredName() + "] parameter for partition-based include"


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?