Parent field mapping must contain the type option – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-6.8

Briefly, this error occurs when the [_parent] field in an Elasticsearch mapping is missing the [type] option. The [type] option is necessary to specify the parent document type. To resolve this issue, you can add the [type] option to the [_parent] field in your mapping. Alternatively, you can remove the [_parent] field if it’s not necessary for your use case. It’s also important to ensure that the parent type exists in your index before referencing it in the [_parent] field.

This guide will help you check for common problems that cause the log ” [_parent] field mapping must contain the [type] option ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: mapping, index.

Log Context

Log “[_parent] field mapping must contain the [type] option” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth 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");
 name = joinField(parentType);
 return new ParentFieldMapper(createParentJoinFieldMapper(documentType; context); fieldType;
 parentType; context.indexSettings());


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?