Setting doc values cannot be modified for field name – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-7.9

Before you dig into reading this guide, have you tried asking OpsGPT what this log means? You’ll receive a customized analysis of your log.

Try OpsGPT now for step-by-step guidance and tailored insights into your Elasticsearch operation.

Briefly, this error occurs when there’s an attempt to modify the [doc_values] setting for an existing field in Elasticsearch. Doc_values are used for sorting, aggregations, and in scripts. Once a field is created with a certain doc_values setting, it cannot be changed. To resolve this, you can create a new index with the desired settings and reindex your data. Alternatively, you can add a new field to the existing index with the correct settings and migrate your data to the new field.

For a complete solution to your to your search operation, try for free AutoOps for Elasticsearch & OpenSearch . With AutoOps and Opster’s proactive support, you don’t have to worry about your search operation – we take charge of it. Get improved performance & stability with less hardware.

This guide will help you check for common problems that cause the log ” Setting [doc_values] cannot be modified for field [” + name + “] ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: plugins, index.

Log Context

Log “Setting [doc_values] cannot be modified for field [” + name + “]” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 throws MapperParsingException {
 Builder builder = new Builder(name);  // tweaking these settings is no longer allowed; the entire purpose of murmur3 fields is to store a hash
 if (node.get("doc_values") != null) {
 throw new MapperParsingException("Setting [doc_values] cannot be modified for field [" + name + "]");
 if (node.get("index") != null) {
 throw new MapperParsingException("Setting [index] cannot be modified for field [" + name + "]");


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?