{"record":{"id":"57fd258fea74393c","repo":"elastic/elasticsearch","slug":"the-edgengram-tokenizer-name-was-deprecated-in-7","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":393,"sourceCode":"            if (indexSettings.getIndexVersionCreated().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 (indexSettings.getIndexVersionCreated().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 NGramTokenizerFactory(indexSettings, environment, name, settings);\n        });\n        tokenizers.put(\"ngram\", NGramTokenizerFactory::new);\n        tokenizers.put(\"edgeNGram\", (IndexSettings indexSettings, Environment environment, String name, Settings settings) -> {\n            if (indexSettings.getIndexVersionCreated().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 (indexSettings.getIndexVersionCreated().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            return new EdgeNGramTokenizerFactory(indexSettings, environment, name, settings);\n        });\n        tokenizers.put(\"edge_ngram\", EdgeNGramTokenizerFactory::new);\n        tokenizers.put(\"char_group\", CharGroupTokenizerFactory::new);\n        tokenizers.put(\"classic\", ClassicTokenizerFactory::new);\n        tokenizers.put(\"letter\", LetterTokenizerFactory::new);\n        // TODO deprecate and remove in API","sourceCodeStart":375,"sourceCodeEnd":411,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonAnalysisPlugin.java#L375-L411","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:393 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"analyzedSha":"db6a809a667c081ca1dc7500389d26975573215f","analyzedAt":"2026-08-12T01:39:14.192Z","schemaVersion":2},"datasetVersion":"2026-08-12T08:17:17.861Z"}