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
| Input | Type | Description |
|---|---|---|
| list | List | List of text values, or objects with a searchable text field. |
| pattern | Text | Search text. An empty search returns no matches. |
| propertyPath | Text | For 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. |
| threshold | Number | Match tolerance from 0 (strictest) to 10 (loosest). New nodes default to 6; keep a valid numeric value configured. |
Outputs
| Output | Type | Description |
|---|---|---|
| filteredResults | List | Matching 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.