Skip to main content
You can use Rules to detect a specific word and modify a query setting because of this word.

​
Limit the search to only a subset of attributes

​
Use Case: title or ID (SKU) searches

A good example of altering a query is with an online document library that allows keyword searches inside documents. If a user types in the word “article ref21”, they are probably signalling to the system that they are looking for an article whose title or ID contains “ref21”.

​
Rule

If query = “article ref21” then remove article and search for an article whose title or ID contains ‘ref21’

​
API

var response = await client.SaveRuleAsync(
  "ALGOLIA_INDEX_NAME",
  "article-rule",
  new Rule
  {
    ObjectID = "article-rule",
    Conditions = new List
    {
      new Condition { Pattern = "article", Anchoring = Enum.Parse("StartsWith") },
    },
    Consequence = new Consequence
    {
      Params = new ConsequenceParams
      {
        Query = new ConsequenceQuery(
          new ConsequenceQueryObject
          {
            Edits = new List
            {
              new Edit { Type = Enum.Parse("Remove"), Delete = "article" },
            },
          }
        ),
        RestrictSearchableAttributes = new List { "title", "book_id" },
      },
    },
  }
);

​
Using the dashboard

You can also add your rules in your Algolia dashboard.
  1. Select the Search product icon on your dashboard and then select your index.
  2. Select the Rules section from the left sidebar menu in the Algolia dashboard.
  3. Under the heading Rules, select the index you are adding a Rule to.
  4. Click the New rule button.
  5. Select Create your first rule or New rule. In the dropdown, click on the Manual Editor option.
  6. In the Condition(s) section, keep Query toggled on, select Contains in the dropdown, and enter “article” in the input field.
  7. In the Consequence(s) section:
    • Click the Add consequence button and select Add Query Parameter.
    • In the input field that appears, enter the JSON search parameter you want to add. For example, { "restrictSearchableAttributes": ["title","id"] }.
    • Click the Add consequence button again and select Remove Word.
    • Type or select “article” in the input field.
  8. Don’t forget to save your changes.
⌘I