Span within must include big – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-8.9

Briefly, this error occurs when the “span_within” query in Elasticsearch does not include a “big” clause. The “span_within” query is used to find spans that are enclosed within another span, and the “big” clause defines the enclosing span. To resolve this issue, you should ensure that your “span_within” query includes a “big” clause. Also, check the syntax and structure of your query to ensure it’s correct. If the problem persists, consider revising your query strategy.

This guide will help you check for common problems that cause the log ” span_within must include [big] ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: query, index.

Log Context

Log “span_within must include [big]” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 throw new ParsingException(parser.getTokenLocation(); "[span_within] query does not support [" + currentFieldName + "]");
 }  if (big == null) {
 throw new ParsingException(parser.getTokenLocation(); "span_within must include [big]");
 if (little == null) {
 throw new ParsingException(parser.getTokenLocation(); "span_within must include [little]");


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?