Debug rules

If you have many rules, it can be difficult to understand which rules apply to a given . Algolia provides tools to help you with this. The getRankingInfo parameter adds extra information about rules:

Promoted hits are labeled with a "promoted": true field inside the _rankingInfo object. This field is omitted from regular hits.
The list of applied Rules is available inside the appliedRules top-level field. This field is omitted when no rule has been applied (even if enableRules is true).

The params response field also has search parameters after Rule application, and as such reflects the side-effects of the rules.

When in doubt, you can always run the same query with enableRules=false and compare the results you get with and without rules.

Improve accuracy of rules

Sometimes, creating rules can lead to lower search accuracy. The following table lists common causes for a lower-than-expected search accuracy when applying rules.

Cause of less accurate results	Solution
Not adding a “remove word” consequence when turning search phrases into query parameters	Add a remove word consequence after any add query parameter consequence
Not creating an optional filter as a facet	If you want to use an attribute as an optional filter, declare it as a facet
Not taking advantage of “add search parameter” consequences	See some common uses for this consequence

Last modified on May 19, 2026

Rules matching algorithm

Detect intent

Search and Discovery platform

Optimization and Personalization

AI-powered experiences

Production and scale

Improve accuracy of rules

​Improve accuracy of rules

Improve accuracy of rules