elasticsearch/docs/reference/text-analysis/analysis-simple-analyzer.md
Colleen McGinnis 9bcd59596d
[docs] Prepare for docs-assembler (#125118)
* reorg files for docs-assembler and create toc.yml files

* fix build error, add redirects

* only toc

* move images
2025-03-20 12:09:12 -05:00

62 lines
1.4 KiB
Markdown

---
navigation_title: "Simple"
mapped_pages:
- https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-simple-analyzer.html
---
# Simple analyzer [analysis-simple-analyzer]
The `simple` analyzer breaks text into tokens at any non-letter character, such as numbers, spaces, hyphens and apostrophes, discards non-letter characters, and changes uppercase to lowercase.
## Example [analysis-simple-analyzer-ex]
```console
POST _analyze
{
"analyzer": "simple",
"text": "The 2 QUICK Brown-Foxes jumped over the lazy dog's bone."
}
```
The `simple` analyzer parses the sentence and produces the following tokens:
```text
[ the, quick, brown, foxes, jumped, over, the, lazy, dog, s, bone ]
```
## Definition [analysis-simple-analyzer-definition]
The `simple` analyzer is defined by one tokenizer:
Tokenizer
: * [Lowercase Tokenizer](/reference/text-analysis/analysis-lowercase-tokenizer.md)
## Customize [analysis-simple-analyzer-customize]
To customize the `simple` analyzer, duplicate it to create the basis for a custom analyzer. This custom analyzer can be modified as required, usually by adding token filters.
```console
PUT /my-index-000001
{
"settings": {
"analysis": {
"analyzer": {
"my_custom_simple_analyzer": {
"tokenizer": "lowercase",
"filter": [ <1>
]
}
}
}
}
}
```
1. Add token filters here.