Span not include must be of type span query – How to solve this OpenSearch exception

Opster Team

Aug-23, Version: 1-2.9

Before you dig into reading this guide, have you tried asking OpsGPT what this log means? You’ll receive a customized analysis of your log.

Try OpsGPT now for step-by-step guidance and tailored insights into your OpenSearch operation.

Briefly, this error occurs when the “span_not” query in OpenSearch is not correctly formatted. The “span_not” query requires a “span” type query in its “include” and “exclude” clauses. If any other type of query is used, this error will be thrown. To resolve this issue, ensure that the “include” and “exclude” clauses of your “span_not” query are of type “span”. Check your query syntax and structure, and correct any discrepancies.

For a complete solution to your to your search operation, try for free AutoOps for Elasticsearch & OpenSearch . With AutoOps and Opster’s proactive support, you don’t have to worry about your search operation – we take charge of it. Get improved performance & stability with less hardware.

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

Log Context

Log “span_not [include] must be of type span query” class name is We extracted the following from OpenSearch source code for those seeking an in-depth context :

 currentFieldName = parser.currentName();
 } else if (token == XContentParser.Token.START_OBJECT) {
 if (INCLUDE_FIELD.match(currentFieldName; parser.getDeprecationHandler())) {
 QueryBuilder query = parseInnerQueryBuilder(parser);
 if (query instanceof SpanQueryBuilder == false) {
 throw new ParsingException(parser.getTokenLocation(); "span_not [include] must be of type span query");
 include = (SpanQueryBuilder) query;
 checkNoBoost(NAME; currentFieldName; parser; include);
 } else if (EXCLUDE_FIELD.match(currentFieldName; parser.getDeprecationHandler())) {
 QueryBuilder query = parseInnerQueryBuilder(parser);


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?

Get expert answers on Elasticsearch/OpenSearch