Include rules for search

This is for:

Merchandiser

In the Search manager of the Coveo Merchandising Hub (CMH), merchandisers can define Include filter rules to ensure that products that meet specific criteria are always included in the search results.

Include filter rules don’t prevent products to be excluded from the search results, nor affect the ranking of the search results. They only ensure that products that meet the specified criteria are included in the search results. For example, if an include rule specifies that products from the Kayak category should be included in the search results, products from other categories, such as Kayak paddles, can still be displayed in the search results.

Tip
Leading practice
  • If you need to exclude specific products from the search results, use Exclude filter rules.

  • If you need to affect the ranking of specific products in the search results, use Ranking rules.

Include filter rules can apply to all queries or to specific queries only.

Include rules | Coveo

Use case examples

Include filter rules can be used to address a variety of use cases. Here are a few examples:

  • For a specific query, you want to ensure that products from a specific category are always included in the search results. For example, when a visitors searches for "Kayak," you want to ensure that products from the Kayak category are displayed in the search results.

  • When your visitors are searching for a specific brand, you want to ensure that products from that brand are displayed in the search results.

  • You want to ensure that products relevant to the current season are always included in the search results. For example, you want to ensure that products having summer as the value of the season attribute are displayed in the search results.

Prerequisites

To create rules, merchandisers must ensure they have properly configured their query pipeline and chosen the correct tracking ID to ensure that their changes impact the intended queries.

Create an include rule

To create a rule:

  1. In the CMH, access the Search manager.

  2. From the navigation tabs, select Filter rules.

  3. Click Create filter rule, and then, Depending on whether you want to apply the include rule to a specific query or to all queries, select the appropriate option.

  4. Select the Locale for which the include rule will apply. By default, a rule applies to all available locales.

  5. Select the Query to which the include rule will apply, and then click Done. Note that if you selected to apply the include rule to all queries, you won’t be able to select a query.

  6. Under Choose an action, select Include.

  7. Under Attribute, select the attribute on which you want to apply the include rule. For example, if you want to include products based on the color attribute, select color.

  8. Under Operator, select the operator that you want to use.

  9. Under Value, select the attribute value that you want to use to filter products. For example, if you want to filter products based on the color attribute, enter the color value that you want to use as a filter, such as red. Note that you can select multiple values for the attribute.

  10. (Optional) If you want to add more attribute-value pairs to the include rule, click Add attribute and repeat the process.

  11. Click Done.

    Tip
    Leading practice

    You can preview the effect of your rules by using the Preview panel on the right side of the page. You can use this panel to simulate queries and see how the rule affects the search results for a given locale.

  12. Review your rule configuration, and then click Publish.

  13. In the Publish now panel, enter a meaningful name for your rule, and then click Publish. The rule now applies.

Manage existing include rules

To manage an existing include rule:

  1. In the CMH, access the Search manager.

  2. From the navigation tabs, select Include rules.

  3. Locate the rule you want to manage.

  4. Click Modify. You can now decide to edit the rule or delete it.