Parameter min doc count and shardMinDocCount must be >=0 in terms aggregation – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-8.9

Briefly, this error occurs when the parameters [min_doc_count] and [shardMinDocCount] in a terms aggregation query are set to a negative value. Both parameters should be greater than or equal to zero. To resolve this issue, you should check your query and ensure that both [min_doc_count] and [shardMinDocCount] are set to zero or a positive integer. If they are set to a negative value, change them to a non-negative value.

This guide will help you check for common problems that cause the log ” parameter [min_doc_count] and [shardMinDocCount] must be >=0 in terms aggregation. ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: search, aggregations.

Log Context

Log “parameter [min_doc_count] and [shardMinDocCount] must be >=0 in terms aggregation.” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 if (requiredSize <= 0 || shardSize <= 0) {
 throw new ElasticsearchException("parameters [required_size] and [shard_size] must be >0 in terms aggregation.");
 }  if (minDocCount < 0 || shardMinDocCount < 0) {
 throw new ElasticsearchException("parameter [min_doc_count] and [shardMinDocCount] must be >=0 in terms aggregation.");
 }  /**
 * The minimum number of documents a bucket must have in order to


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?