# Single Word Search

## Overview

Depending on the product catalog, multi-word queries may lead to few or, in the worst case, zero hits. The **Single Word Search** module improves results by splitting the query into its individual words and performing a search for each word.

The results of the additional per-word searches are included alongside the main results but are not merged into the main hit list. This lets you decide which products to surface to your customers.

For example, the query `Brandname Data Cable` triggers separate searches for `Brandname`, `Data`, and `Cable`.\
You can fine-tune this behavior using the settings below.

## Location

You can find the **Single Word Search** module in the left-hand menu under **More settings… → Single Word Search** in the **Modules** category.

![](/files/QqI5E7KUFOyommljctbc)

## Configuring Single Word Search

**Note:** Single Word Search only affects your live shop. Its effect is not visible in the Demoshop or Cockpit.

![](/files/9KWMU7Af71IkSVUVzeH4)

### Score threshold ![Bullet - 1.png](/files/ninyrTTqJmz4rejC78Id)

Choose whether Single Word Search should activate below a given similarity score or only for zero-hit searches.

For zero hit searches, set the **Score threshold** to 0%.

For example, with a threshold of 90%, Single Word Search triggers when the best score among all found products is below 90%.

### Max. Preview products ![](/files/9i96yYGUZeP2ZjMYqH0e)

FactFinder can display preview products for each word. You can freely set the number of preview products ![](/files/2XF0kf1Bm7Z35I6UtFNL).

Avoid setting a high maximum number of words, as each additional search adds latency.

In addition to the settings described above, you can optimize the result further by using the following two settings:

### Max. words to check ![](/files/wLetB9IQym9IkNx8I8f3)

Limits the number of searches performed. FactFinder only performs searches up to this limit.\
For example, if your query is `Word1 Word2 Word3` and **Max. words to check** is set to 2, no search for `Word3` is performed. Counting always starts from the left.

### Max. number of words ![](/files/tZGRXMuC8JvGAN77qE8x)

Further limit the number of searches with this setting. While **Max. words to check** limits how many words to search, this setting caps how many single-word result sections appear in your results.

Imagine the query: `GoodWord1 BadWord1 BadWord2 GoodWord2 GoodWord3`.\
“Good” words lead to hits; “bad” words lead to zero hits.

With **Max. words to check** set to 2, only the first two words are searched, so only `GoodWord1` can add hits.\
You could change that by setting **Max. words to check** to 4 and **Max. number of words** to 2.

You would then search for `GoodWord1`, `BadWord1`, `BadWord2`, `GoodWord2`.\
`GoodWord3` is ignored because **Max. words to check** is 4.\
Even if set to 5, `GoodWord3` is ignored because **Max. number of words** is 2 and results already exist for `GoodWord1` and `GoodWord2`.

This setting acts as a safeguard against oversized results and redundant searches.

**Max. words to check** ![](/files/Ehk1tMw4qBIWvCgJj7rh) must be greater than or equal to **Max. number of words** ![](/files/UipZ5ADW4CYdVObCmdDS).

The following picture illustrates the effect on the elements ![](/files/afMFqoHYxlD3P4x4s54e) in the Single Word Search result ![](/files/dOZlcoZrhcFshT4JyY3F). The normal search result (independent of Single Word Search) appears in section ![](/files/cVfuaDKK4FYgURysSN7J). If you set the score threshold ![](/files/Ph63z0daepEWYQihI5Tp) to 0%, section ![](/files/cVfuaDKK4FYgURysSN7J) will be empty.

![](/files/N9zS2Fg4Hh5PJDBLDFpG)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fact-finder.com/docs/modules/single-word-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.