Positions increment gap must be positive got – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-7.9

Briefly, this error occurs when the “positions_increment_gap” parameter in Elasticsearch is set to a negative value. This parameter is used to control the number of fake term position which should be inserted between each instance of a field. It must be a positive number. To resolve this issue, you should check your Elasticsearch settings or mapping configurations and ensure that the “positions_increment_gap” parameter is set to a positive value. If it’s not, change it to a positive number and restart Elasticsearch.

This guide will help you check for common problems that cause the log ” [positions_increment_gap] must be positive; got ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: plugins, index.

Log Context

Log “[positions_increment_gap] must be positive; got” class name is AnnotatedTextFieldMapper.java. We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 builder = this;
 }  public Builder positionIncrementGap(int positionIncrementGap) {
 if (positionIncrementGap < 0) {
 throw new MapperParsingException("[positions_increment_gap] must be positive; got " + positionIncrementGap);
 this.positionIncrementGap = positionIncrementGap;
 return this;


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?