{"record":{"id":"a05159453fc77dfc","repo":"elastic/elasticsearch","slug":"the-edgengram-tokenizer-name-was-deprecated-in-7-a05159","errorCode":null,"errorMessage":"The [edgeNGram] tokenizer name was deprecated in 7.6. Please use the tokenizer name to [edge_ngram] for indices created in versions 8 or higher instead.","messagePattern":"The \\[edgeNGram\\] tokenizer name was deprecated in 7\\.6\\. Please use the tokenizer name to \\[edge_ngram\\] for indices created in versions 8 or higher instead\\.","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java","lineNumber":647,"sourceCode":"        tokenizers.add(PreConfiguredTokenizer.indexVersion(\"nGram\", (version) -> {\n            if (version.onOrAfter(IndexVersions.V_8_0_0)) {\n                throw new IllegalArgumentException(\n                    \"The [nGram] tokenizer name was deprecated in 7.6. \"\n                        + \"Please use the tokenizer name to [ngram] for indices created in versions 8 or higher instead.\"\n                );\n            } else if (version.onOrAfter(IndexVersions.V_7_6_0)) {\n                deprecationLogger.warn(\n                    DeprecationCategory.ANALYSIS,\n                    \"nGram_tokenizer_deprecation\",\n                    \"The [nGram] tokenizer name is deprecated and will be removed in a future version. \"\n                        + \"Please change the tokenizer name to [ngram] instead.\"\n                );\n            }\n            return new NGramTokenizer();\n        }));\n        tokenizers.add(PreConfiguredTokenizer.indexVersion(\"edgeNGram\", (version) -> {\n            if (version.onOrAfter(IndexVersions.V_8_0_0)) {\n                throw new IllegalArgumentException(\n                    \"The [edgeNGram] tokenizer name was deprecated in 7.6. \"\n                        + \"Please use the tokenizer name to [edge_ngram] for indices created in versions 8 or higher instead.\"\n                );\n            } else if (version.onOrAfter(IndexVersions.V_7_6_0)) {\n                deprecationLogger.warn(\n                    DeprecationCategory.ANALYSIS,\n                    \"edgeNGram_tokenizer_deprecation\",\n                    \"The [edgeNGram] tokenizer name is deprecated and will be removed in a future version. \"\n                        + \"Please change the tokenizer name to [edge_ngram] instead.\"\n                );\n            }\n            if (version.onOrAfter(IndexVersions.V_7_3_0)) {\n                return new EdgeNGramTokenizer(NGramTokenizer.DEFAULT_MIN_NGRAM_SIZE, NGramTokenizer.DEFAULT_MAX_NGRAM_SIZE);\n            }\n            return new EdgeNGramTokenizer(EdgeNGramTokenizer.DEFAULT_MIN_GRAM_SIZE, EdgeNGramTokenizer.DEFAULT_MAX_GRAM_SIZE);\n        }));\n        tokenizers.add(PreConfiguredTokenizer.singleton(\"PathHierarchy\", PathHierarchyTokenizer::new));\n","sourceCodeStart":629,"sourceCodeEnd":665,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java#L629-L665","documentation":"Error \"The [edgeNGram] tokenizer name was deprecated in 7.6. Please use the tokenizer name to [edge_ngram] for indices created in versions 8 or higher instead.\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java:647 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"db6a809a667c081ca1dc7500389d26975573215f","analyzedAt":"2026-08-12T01:39:14.192Z","schemaVersion":2},"datasetVersion":"2026-08-12T13:17:24.610Z"}