Skip to main content

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

Configuring fuzzy search

Updated on May 11, 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.

Depending on the fuzzy search parameters, when you search for tst, the system returns such results as test and tests.

You can also search for multiple words by entering specific relational operators, for example credit OR card, to retrieve results that contain words approximate either to credit or card. For example, the system displays results with such words as credits, cards, or cord.

Before you begin: Ensure that you have the pxAccessSearchLP privilege to access the Search landing page.
Note: The PegaRULES:SysAdm4 role includes the privilege.
  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