+ NAME + no join field has been configured – 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 Check-Up which can resolve issues that cause many errors.

This guide will help you check for common problems that cause the log ” + NAME + no join field has been configured ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: join and query.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up to analyze Elasticsearch configuration and help resolve this error.

Log Context

Log “[” + NAME + “] no join field has been configured”classname  is HasChildQueryBuilder.java We extracted the following from Elasticsearch source code for those seeking an in-depth context :

ParentJoinFieldMapper joinFieldMapper = ParentJoinFieldMapper.getMapper(context.getMapperService());
 if (joinFieldMapper == null) {
 if (ignoreUnmapped) {
 return new MatchNoDocsQuery();
 } else {
 throw new QueryShardException(context; "[" + NAME + "] no join field has been configured");
 ParentIdFieldMapper parentIdFieldMapper = joinFieldMapper.getParentIdFieldMapper(type; false);
 if (parentIdFieldMapper != null) {


Watch product tour

Watch how AutoOps finds & fixes Elasticsearch problems

Analyze Your Cluster
Skip to content