🎉 Try the public beta of the new docs site at algolia.com/doc-beta! 🎉
Guides / Managing results / Rules / Detecting intent

Dynamic filtering with Rules

To help users find what they’re looking for straight from the search box, you can use Algolia Rules to automatically apply a filter to results if the query matches a facet value.

How to create a dynamic filtering rule

In this example for a product catalog, you create a rule that displays products with the “red” value in the color facet if the query contains the word “red”.

Using the example dataset, this rule ensures that only records with “red” in the color attribute are returned. It ignores “red” in other attributes such as brand.

Query Results
red FM, Clothing, LondonLook, Red, 21.99
The Mandal, Toaster, Black & Decker, Red, 149.99

Using the dashboard

  1. Go to the Algolia dashboard and select your Algolia application.
  2. On the left sidebar, select Algolia Search Search.
  3. Select your Algolia index:

    Select your Algolia application and index

  4. Click Rules in the left sidebar menu.
  5. Select Create your first rule or New rule. In the drop-down menu, click the Manual Editor option.
  6. In the Condition(s) section, with Query toggled on, select Contains in the drop-down menu, and enter “red” in the input field.
  7. In the Consequence(s) section:

    • Click Add consequence and select Add Query Parameter.
    • In the input field that appears, add the JSON parameters you want to apply when the user’s query matches the Rule: {"filters":"color:red"}
    • Click Add consequence and select Remove Word.
    • Type or select “red” in the input field.

    If you click Optional under Consequence(s), this will display non-red products after the red ones. For more information, see Using optional filters.

  8. Save your changes.

Using the API

This example uses the filters parameter. With this approach, you need one rule per filter value. If you have 10 color options, you need 10 rules, one for each color.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
$rule = array(
  'objectID' => 'red-color',
  'conditions' => array(array(
    'pattern' => 'red',
    'anchoring' => 'contains'
  )),
  'consequence' => array(
    'params' => array(
      'query' => array(
        'remove' => 'red'
      ),
      'filters' => 'color:red'
    )
  )
);

// Push Rule to index
$index->saveRule($rule);

Examples

The following examples explore:

One rule per facet

Instead of creating one rule per facet value, this approach uses one rule for the color facet.

Using the example dataset, this single rule ensures that any record with any matching color value in the color attribute will be returned.

Query Results
red FM, Clothing, LondonLook, Red, 21.99
The Mandal, Toaster, Black & Decker, Red, 149.99
black Will Carpenter, T-shirt, Red or Dead, Black, 199.99

Using the dashboard

  1. Create a new rule. See how to create a dynamic filtering rule.
  2. In the Manual Editor’s Condition(s), click the box next to Query contains and select the option Add Facet “color” from the drop-down menu.
  3. In the Consequence(s) section:

    • Click Add consequence and select Filter/Boost Matching Attributes.
    • Click the Filter box that appears and select the option Add Facet “color” from the drop-down menu.
  4. Save your changes.

Using the API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// Turn JSON into an array
$rule = array(
  'objectID' => 'color-facets',
  'conditions' => array(array(
    'pattern' => '{facet:color}'
  )),
  'consequence' => array(
    'params' => array(
      'automaticFacetFilters' => ['color']
    )
  )
);

// Push Rule to index
$index->saveRule($rule['objectID'], $rule);

Numerical dynamic filtering

Consider a user entering the query “cheap toaster 800w”. You can use two rules together to filter results by:

  1. The product type: “Toaster”
  2. “Cheapness”. You determine that a cheap product is any product that costs less than $15.

Using the example dataset, these rules ensure that any product that costs less than $15, has the product_type “Toaster” and includes the phrase “800w” is returned.

Query Results
cheap toaster 800w Essentials 800w, Toaster, Daewoo, Black, 14.99

Using the dashboard

Create the first rule:

  1. Create a new rule. See how to create a dynamic filtering rule.
  2. In the Manual Editor’s Condition(s), with Query toggled on, select Contains in the drop-down menu, and enter “toaster” in the input field.
  3. In the Consequence(s) section:

    • Click Add consequence and select Add Query Parameter.
    • In the input field that appears, enter {"filters":"product_type:toaster"}
    • Click Add consequence and select Remove Word.
    • Type or select “toaster” in the input field.
  4. Save your changes.

Create the second rule:

  1. Create a new rule
  2. In the Manual Editor’s Condition(s), with Query toggled on, select Contains in the drop-down menu, and enter “cheap” in the input field.
  3. In the Consequence(s) section:

    • Click Add consequence and select Add Query Parameter.
    • In the input field that appears, enter {"filters":"price < 10"}
    • Click Add consequence and select Remove Word.
    • Type or select “cheap” in the input field.
  4. Save your changes.

Using the API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Turn JSON into an array
$rules = array(
  array(
    'objectID' => 'toaster',
    'conditions' => array(array(
      'pattern' => 'toaster',
      'anchoring' => 'contains'
    )),
    'consequence' => array(
      'params' => array(
        'query' => array(
          'remove' => 'toaster'
        ),
        'filters' => 'product_type:toaster'
      )
    )
  ),
  array(
    'objectID' => 'cheap',
    'condition' => array(
      'pattern' => 'cheap',
      'anchoring' => 'contains'
    ),
    'consequence' => array(
      'params' => array(
        'query' => array(
          'remove' => 'cheap'
        ),
        'filters' => 'price < 15'
      )
    )
  )
);

// Push Rule to index
$index->saveRules($rules);

Tagged filters

Consider a user who enters the query “apple headphones”. They would expect to search for results that match the term “headphones”, but only where the brand attribute matches “apple”. You can find this behavior on sites such as GitHub. It’s a great alternative to filters for users who prefer to type rather than click.

This approach is similar to one rule per facet.

Using the example dataset, this rule ensures that any record containing the phrase “headphones” that also has “Apple” in the brand attribute will be returned. It won’t return non-Apple brands, even if the phrase “Apple” appears in other attributes.

Query Results
apple headphones Airpods Max, Headphones, Apple, Gray, 548.99

Using the dashboard

  1. Create a new rule as above
  2. In the Manual Editor’s Condition(s), click the box next to Query contains and select the option Add Facet “brand” from the drop-down menu.
  3. Clear the Apply to plurals, synonyms and typos checkbox to ensure precise matching of the brand name.
  4. In the Consequence(s) section:

    • Click Add consequence and select Filter/Boost Matching Attributes.
    • Click the Filter box that appears and select the option Add Facet “brand” from the drop-down menu.
    • Click Add consequence and select Remove word.
    • In the input that appears, select Remove {facet:brand}.
  5. Save your changes.

Using the API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
$rule = array (
  'conditions' => array(
  array (
    'pattern' => 'brand\\: {facet:brand}',
    'anchoring' => 'contains',
    'alternatives' => false,
  )),
  'consequences' =>
  array (
    array (
      'params' =>
      array (
        'automaticFacetFilters' =>
        array (
          'brand',
        ),
        'query' =>
        array (
          'remove' =>
          array (
            'brand\\:',
            '{facet:brand}',
          ),
        ),
      ),
    ),
  ),
  'description' => 'filter on brand: {brand}',
  'objectID' => 'tagged-brand-rule',
);

$response = $index->saveRule($rule['objectID'], $rule);

Example dataset

All the examples on this page use a product catalog index. The appropriate attributes have been set as attributes for faceting. The index has records that look like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
[
    {
      "product_name": "FM",
      "product_type": "T-shirt",
      "brand": "LondonLook",
      "color": "Red",
      "price": 21.99
    },
    {
      "product_name": "Caveman",
      "product_type": "T-shirt",
      "brand": "Red or Dead",
      "color": "Brown",
      "price": 9.99
    },
    {
      "product_name": "iPhone 13 Pro Max",
      "product_type": "Phone",
      "brand": "Apple",
      "color": "Blue",
      "price": 1824.61
    },
    {
      "product_name": "Will Carpenter",
      "product_type": "T-shirt",
      "brand": "Red or Dead",
      "color": "Black",
      "price": 199.99
    },
    {
      "product_name": "The Mandal 800w",
      "product_type": "Toaster",
      "brand": "Black & Decker",
      "color": "Red",
      "price": 149.99
    },
    {
      "product_name": "Essentials 800w",
      "product_type": "Toaster",
      "brand": "Daewoo",
      "color": "Black",
      "price": 14.99
    },
    {
      "product_name": "Airpods Max",
      "product_type": "Headphones",
      "brand": "Apple",
      "color": "Gray",
      "price": 548.99
    },
    {
      "product_name": "WH-CH520",
      "product_type": "Headphones",
      "brand": "Sony",
      "color": "Apple",
      "price": 39.99
    }
]

See also

Did you find this page helpful?