{"record":{"id":"a840771114888869","repo":"elastic/elasticsearch","slug":"missing-or-empty-common-words-or-common-words-p","errorCode":null,"errorMessage":"missing or empty [common_words] or [common_words_path] configuration for common_grams token filter","messagePattern":"missing or empty \\[common_words\\] or \\[common_words_path\\] configuration for common_grams token filter","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonGramsTokenFilterFactory.java","lineNumber":38,"sourceCode":"import org.elasticsearch.index.analysis.Analysis;\nimport org.elasticsearch.index.analysis.TokenFilterFactory;\n\npublic class CommonGramsTokenFilterFactory extends AbstractTokenFilterFactory {\n\n    private final CharArraySet words;\n\n    private final boolean ignoreCase;\n\n    private final boolean queryMode;\n\n    CommonGramsTokenFilterFactory(IndexSettings indexSettings, Environment env, String name, Settings settings) {\n        super(name);\n        this.ignoreCase = settings.getAsBoolean(\"ignore_case\", false);\n        this.queryMode = settings.getAsBoolean(\"query_mode\", false);\n        this.words = Analysis.parseCommonWords(env, settings, null, ignoreCase);\n\n        if (this.words == null) {\n            throw new IllegalArgumentException(\n                \"missing or empty [common_words] or [common_words_path] configuration for common_grams token filter\"\n            );\n        }\n    }\n\n    @Override\n    public TokenStream create(TokenStream tokenStream) {\n        CommonGramsFilter filter = new CommonGramsFilter(tokenStream, words);\n        if (queryMode) {\n            return new CommonGramsQueryFilter(filter);\n        } else {\n            return filter;\n        }\n    }\n\n    @Override\n    public TokenFilterFactory getSynonymFilter() {\n        throw new IllegalArgumentException(\"Token filter [\" + name() + \"] cannot be used to parse synonyms\");","sourceCodeStart":20,"sourceCodeEnd":56,"githubUrl":"https://github.com/elastic/elasticsearch/blob/db6a809a667c081ca1dc7500389d26975573215f/modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonGramsTokenFilterFactory.java#L20-L56","documentation":"Error \"missing or empty [common_words] or [common_words_path] configuration for common_grams token filter\" thrown in elastic/elasticsearch.","triggerScenarios":"Thrown at modules/analysis-common/src/main/java/org/elasticsearch/analysis/common/CommonGramsTokenFilterFactory.java:38 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-13T09:17:06.757Z"}