Parent field is disabled on indices with a single type – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-6.8

Briefly, this error occurs when you’re trying to use the [_parent] field in Elasticsearch 6.x or later versions, which have removed the support for multiple types per index. The [_parent] field was used to establish parent-child relationships between documents of different types in the same index. To resolve this issue, you can use the “join” field to model parent-child relationships, or restructure your data to avoid the need for parent-child relationships. Alternatively, you could use separate indices for each type if the parent-child relationship is not crucial.

This guide will help you check for common problems that cause the log ” [_parent] field is disabled on indices with a single type. ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: index, indices.

Log Context

Log “[_parent] field is disabled on indices with a single type.” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 }  @Override
 public ParentFieldMapper build(BuilderContext context) {
 if (context.indexCreatedVersion().onOrAfter(Version.V_6_5_0)) {
 throw new MapperParsingException("[_parent] field is disabled on indices with a single type. " +
 "Use a [join] field instead.");
 if (parentType == null) {
 throw new MapperParsingException("[_parent] field mapping must contain the [type] option");


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?