Duplicate alias – How to solve this Elasticsearch error

Opster Team

July-20, Version: 1.7-8.0

Before you begin reading this guide, we recommend you try running the Elasticsearch Error Check-Up which analyzes 2 JSON files to detect many configuration errors.

Briefly, this error message may occur when attempting to create an alias in Elasticsearch that already exists. This can occur when creating an alias for an index or for a search query. To resolve this issue, ensure that the alias name is unique and that it has not already been created for the desired index or query.

To easily locate the root cause and resolve this issue try AutoOps for Elasticsearch & OpenSearch. It diagnoses problems by analyzing hundreds of metrics collected by a lightweight agent and offers guidance for resolving them.

This guide will help you check for common problems that cause the log ” Duplicate alias ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: parser, alias and plugin.

Log Context

Log “Duplicate alias {}”classname  is LogicalPlanBuilder.java We extracted the following from Elasticsearch source code for those seeking an in-depth context :

// unwrap query (and validate while at it)
 Map cteRelations = new LinkedHashMap<>(namedQueries.size());
 for (SubQueryAlias namedQuery : namedQueries) {
 if (cteRelations.put(namedQuery.alias(); namedQuery) != null) {
 throw new ParsingException(namedQuery.source(); "Duplicate alias {}"; namedQuery.alias());
 // return WITH
 return new With(source(ctx); body; cteRelations);


See how you can use AutoOps to resolve issues

How useful 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?

Analyze your cluster & get personalized recommendations

Skip to content