---
title: Stemmer override token filter
description: Overrides stemming algorithms, by applying a custom mapping, then protecting these terms from being modified by stemmers. Must be placed before any stemming...
url: https://www.elastic.co/elastic/docs-builder/docs/3016/reference/text-analysis/analysis-stemmer-override-tokenfilter
products:
  - Elasticsearch
---

# Stemmer override token filter
Overrides stemming algorithms, by applying a custom mapping, then protecting these terms from being modified by stemmers. Must be placed before any stemming filters.
Rules are mappings in the form of `token1[, ..., tokenN] => override`.

| Setting      | Description                                                                      |
|--------------|----------------------------------------------------------------------------------|
| `rules`      | A list of mapping rules to use.                                                  |
| `rules_path` | A path (either relative to `config` location, orabsolute) to a list of mappings. |

Here is an example:
```json

{
  "settings": {
    "analysis": {
      "analyzer": {
        "my_analyzer": {
          "tokenizer": "standard",
          "filter": [ "lowercase", "custom_stems", "porter_stem" ]
        }
      },
      "filter": {
        "custom_stems": {
          "type": "stemmer_override",
          "rules_path": "analysis/stemmer_override.txt"
        }
      }
    }
  }
}
```

Where the file looks like:
```text
running, runs => run

stemmer => stemmer
```

You can also define the overrides rules inline:
```json

{
  "settings": {
    "analysis": {
      "analyzer": {
        "my_analyzer": {
          "tokenizer": "standard",
          "filter": [ "lowercase", "custom_stems", "porter_stem" ]
        }
      },
      "filter": {
        "custom_stems": {
          "type": "stemmer_override",
          "rules": [
            "running, runs => run",
            "stemmer => stemmer"
          ]
        }
      }
    }
  }
}
```