---
navigation_title: "Keep words"
mapped_pages:
  - https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-keep-words-tokenfilter.html
---

# Keep words token filter [analysis-keep-words-tokenfilter]


Keeps only tokens contained in a specified word list.

This filter uses Lucene’s [KeepWordFilter](https://lucene.apache.org/core/10_0_0/analysis/common/org/apache/lucene/analysis/miscellaneous/KeepWordFilter.md).

::::{note}
To remove a list of words from a token stream, use the [`stop`](/reference/text-analysis/analysis-stop-tokenfilter.md) filter.

::::


## Example [analysis-keep-words-tokenfilter-analyze-ex]

The following [analyze API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-analyze) request uses the `keep` filter to keep only the `fox` and `dog` tokens from `the quick fox jumps over the lazy dog`.

```console
GET _analyze
{
  "tokenizer": "whitespace",
  "filter": [
    {
      "type": "keep",
      "keep_words": [ "dog", "elephant", "fox" ]
    }
  ],
  "text": "the quick fox jumps over the lazy dog"
}
```

The filter produces the following tokens:

```text
[ fox, dog ]
```


## Configurable parameters [analysis-keep-words-tokenfilter-configure-parms]

`keep_words`
:   (Required*, array of strings) List of words to keep. Only tokens that match words in this list are included in the output.

Either this parameter or `keep_words_path` must be specified.


`keep_words_path`
:   (Required*, array of strings) Path to a file that contains a list of words to keep. Only tokens that match words in this list are included in the output.

This path must be absolute or relative to the `config` location, and the file must be UTF-8 encoded. Each word in the file must be separated by a line break.

Either this parameter or `keep_words` must be specified.


`keep_words_case`
:   (Optional, Boolean) If `true`, lowercase all keep words. Defaults to `false`.


## Customize and add to an analyzer [analysis-keep-words-tokenfilter-customize]

To customize the `keep` filter, duplicate it to create the basis for a new custom token filter. You can modify the filter using its configurable parameters.

For example, the following [create index API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-indices-create) request uses custom `keep` filters to configure two new [custom analyzers](docs-content://manage-data/data-store/text-analysis/create-custom-analyzer.md):

* `standard_keep_word_array`, which uses a custom `keep` filter with an inline array of keep words
* `standard_keep_word_file`, which uses a customer `keep` filter with a keep words file

```console
PUT keep_words_example
{
  "settings": {
    "analysis": {
      "analyzer": {
        "standard_keep_word_array": {
          "tokenizer": "standard",
          "filter": [ "keep_word_array" ]
        },
        "standard_keep_word_file": {
          "tokenizer": "standard",
          "filter": [ "keep_word_file" ]
        }
      },
      "filter": {
        "keep_word_array": {
          "type": "keep",
          "keep_words": [ "one", "two", "three" ]
        },
        "keep_word_file": {
          "type": "keep",
          "keep_words_path": "analysis/example_word_list.txt"
        }
      }
    }
  }
}
```