Skip to main content

Fuzzy Filter

Uncontrolled node

Overview​

Find approximate text matches in a list.

Search a list for text that approximately matches a query. Useful for finding names or labels when spelling may vary. Results contain the original matching items, ordered by match relevance rather than their original list position.

This node is evaluated when another node needs its output. It has no run or done event.

Inputs​

InputTypeDescription
listListList of text values, or objects with a searchable text field.
patternTextSearch text. An empty search returns no matches.
propertyPathTextFor objects, specify the text field to search, such as name or address.city. Leave unset for a list of strings; it does not automatically search every object field.
thresholdNumberMatch tolerance from 0 (strictest) to 10 (loosest). New nodes default to 6; keep a valid numeric value configured.

Outputs​

OutputTypeDescription
filteredResultsListMatching original items, not scores or just the matched field. Returns [] when the input is not a list, the query is not text or there are no matches.

Choosing a threshold​

Start with 6, then lower it if unrelated results appear or raise it if useful approximate matches are missing. A threshold is a search tolerance, not a confidence percentage. Even a strict fuzzy search is not the same as whole-value equality; use List Includes for an exact value check.

Example​

Connect this list:

[
{ "name": "John Smith", "age": 30 },
{ "name": "Jane Doe", "age": 25 },
{ "name": "Johnny Walker", "age": 40 }
]

Set pattern to John, propertyPath to name and threshold to 4. The matching results are:

[
{ "name": "John Smith", "age": 30 },
{ "name": "Johnny Walker", "age": 40 }
]

For a nested object field, use a path such as address.city. Inspect results with representative data before relying on a chosen tolerance.