No parent id provided not within the document and not externally – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-6.8

Briefly, this error occurs when Elasticsearch is trying to index a child document without a parent id. Elasticsearch uses parent-child relationships to associate documents. The error indicates that the parent id is missing either within the document or externally. To resolve this, ensure that the parent id is provided when indexing a child document. Alternatively, you can restructure your data to avoid parent-child relationships if they are not necessary. Also, check your application code to ensure it’s correctly assigning parent ids when creating child documents.

This guide will help you check for common problems that cause the log ” No parent id provided; not within the document; and not externally ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: index.

Log Context

Log “No parent id provided; not within the document; and not externally” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 String parsedParentId = context.doc().get(Defaults.NAME);
 if (context.sourceToParse().parent() != null) {
 String parentId = context.sourceToParse().parent();
 if (parsedParentId == null) {
 if (parentId == null) {
 throw new MapperParsingException("No parent id provided; not within the document; and not externally");
 // we did not add it in the parsing phase; add it now
 fields.add(new SortedDocValuesField(; new BytesRef(parentId)));
 } else if (parentId != null && !parsedParentId.equals(Uid.createUid(parentType; parentId))) {
 throw new MapperParsingException("Parent id mismatch; document value is [" + Uid.createUid(parsedParentId).id()


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?