Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Configuring fuzzy search

Updated on April 5, 2022

You can configure how search works when you perform a fuzzy search query in a custom search tool. Fuzzy search queries look for approximate spellings that match the entered search string, and find matches if you misspell a term, or are uncertain of its spelling. For example, entering “tst" matches terms like "test," "tests," and so on, depending on how the fuzzy search parameters are set.

Before you begin: To access the Search landing page, you must have the pxAccessSearchLP privilege, which is included in the PegaRULES:SysAdm4 role.

For more information about how Elasticsearch implements fuzzy search queries, go to the Elasticsearch website at

  1. In the header of Dev Studio, click ConfigureSystemSettingsSearch.
  2. In the Settings section, in the Degree of fuzziness field, select the edit distance, that is, the search string length within which the approximate matching of characters occurs. If you select Auto, the maximum edit distance is:
    • 0 for strings of one or two characters.
    • 1 for strings of three, four, or five characters.
    • 2 for strings of more than five characters.
    For example, performing a fuzzy search query for the term "catchr" with a degree of fuzziness of 1, finds matches like "catch" (by deleting 1 character) and "catcher" (by adding 1 character), but does not find matches like "catches" (by adding 1 character and replacing 1, which adds up to an edit distance of 2).
  3. In the Prefix length field, enter the number of initial characters in the entered string to which fuzzy matching does not apply, given that the initial characters match exactly. Increasing this parameter value results in faster search queries.
    For example, performing a fuzzy search query for the term "windwo" with a prefix length of 3, does not apply fuzzy search to the first 3 characters "win," and applies fuzzy search to the rest of the characters to find matches like "window," "winter," "winner," and so on.
  4. In the Maximum expansion terms field, enter the number of alternative spellings for the search string that you want to allow while searching. Decreasing this parameter value results in faster search queries, but might not return as many potential matches.
    For example, performing a fuzzy search query for the term "codngi" with 2 maximum expansion terms, finds only 2 matches like "code" and "coding".
  5. Click Save Settings.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us