Field masking span query does not support – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-7.14

Briefly, this error occurs when a field_masking_span query is used with a field that it does not support. The field_masking_span query is used to match spans containing a term within a given field, but not all fields are compatible with this query. To resolve this issue, ensure that the field you’re querying supports the field_masking_span query. If it doesn’t, consider using a different query type or reindexing your data to make it compatible with the field_masking_span query.

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

Log Context

Log “[field_masking_span] query does not support [” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 throw new ParsingException(parser.getTokenLocation(); "[field_masking_span] query must be of type span query");
 inner = (SpanQueryBuilder) query;
 checkNoBoost(NAME; currentFieldName; parser; inner);
 } else {
 throw new ParsingException(parser.getTokenLocation(); "[field_masking_span] query does not support ["
 + currentFieldName + "]");
 } else {
 if (AbstractQueryBuilder.BOOST_FIELD.match(currentFieldName; parser.getDeprecationHandler())) {
 boost = parser.floatValue();