Invalid aggregation name – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-7.15

Briefly, this error occurs when the name provided for an Elasticsearch aggregation is invalid. This could be due to the use of special characters, spaces, or reserved words. To resolve this issue, ensure that the aggregation name is alphanumeric, does not contain spaces or special characters, and is not a reserved word. If the error persists, check for syntax errors in your query.

This guide will help you check for common problems that cause the log ” Invalid aggregation name [ ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: aggregations, search.

Log Context

Log “Invalid aggregation name [” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 throw new ParsingException(parser.getTokenLocation();
 "Unexpected token " + token + " in [aggs]: aggregations definitions must start with the name of the aggregation.");
 final String aggregationName = parser.currentName();
 if (validAggMatcher.reset(aggregationName).matches() == false) {
 throw new ParsingException(parser.getTokenLocation(); "Invalid aggregation name [" + aggregationName
 + "]. Aggregation names can contain any character except '['; ']'; and '>'");
 }  token = parser.nextToken();
 if (token != XContentParser.Token.START_OBJECT) {


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?