{"record":{"id":"44328339d253860b","repo":"elastic/elasticsearch","slug":"token-filter-cannot-be-used-to-parse-synonyms-443283","errorCode":null,"errorMessage":"Token filter [{}] cannot be used to parse synonyms","messagePattern":"Token filter \\[(.+?)\\] cannot be used to parse synonyms","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/NGramTokenFilterFactory.java","lineNumber":53,"sourceCode":"                    + maxAllowedNgramDiff\n                    + \"] but was [\"\n                    + ngramDiff\n                    + \"]. This limit can be set by changing the [\"\n                    + IndexSettings.MAX_NGRAM_DIFF_SETTING.getKey()\n                    + \"] index level setting.\"\n            );\n        }\n        preserveOriginal = settings.getAsBoolean(PRESERVE_ORIG_KEY, false);\n    }\n\n    @Override\n    public TokenStream create(TokenStream tokenStream) {\n        return new NGramTokenFilter(tokenStream, minGram, maxGram, preserveOriginal);\n    }\n\n    @Override\n    public TokenFilterFactory getSynonymFilter() {\n        throw new IllegalArgumentException(\"Token filter [\" + name() + \"] cannot be used to parse synonyms\");\n    }\n}\n","sourceCodeStart":35,"sourceCodeEnd":56,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/NGramTokenFilterFactory.java#L35-L56","documentation":"Error \"Token filter [{}] cannot be used to parse synonyms\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/NGramTokenFilterFactory.java:53 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"}