--- title: Include rules for product listing pages slug: o5sf2528 canonical_url: https://docs.coveo.com/en/o5sf2528/ collection: coveo-merchandising-hub source_format: adoc --- # Include rules for product listing pages In the [Product listings manager](https://docs.coveo.com/en/p64e0262/) of the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/), merchandisers can define _include_ filter rules to ensure that specific products are always included on [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/). Include filter rules don't prevent products from being excluded from PLPs, nor do they affect the ranking of the products on these pages. They only ensure that products meeting specified criteria are included on PLPs. For example, you have a PLP that displays products from the "Canoes & Kayaks" category, and you want to include additional accessories on the page, such as dry bags. > **Leading practice** > > * To exclude specific products from a PLP, use [exclude filter rules](https://docs.coveo.com/en/o5sf3251/). > > * To affect the ranking of specific products on a PLP, use [ranking rules](https://docs.coveo.com/en/o5sf2373/). Include filter rules can apply to all PLPs or to one or more specific PLPs. They can also be scheduled for a specific time, letting merchandisers plan and execute their strategies more effectively. ![Include rule for product listing pages | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-listings-include-rule.png) ## Use case examples Include filter rules can be used to address a variety of use cases. Here are a few examples: * You want to ensure that new arrivals are always included on a PLP. For example, you can create a rule to ensure that products marked as `new arrivals` are displayed on the PLP. * You want to ensure that promotional items are included on the PLP. For example, during a sale, you can create a rule to ensure that products that have the `ec_promo_price` attribute are displayed on the PLP. * You want to ensure that products with specific attributes are included on the PLP. For example, if you have a page dedicated to eco-friendly products, you can create a rule to ensure products with `eco-friendly` as the value of the `sustainability` attribute are displayed. ## Prerequisites Before you create rules in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/): * In the [Coveo Administration Console](https://docs.coveo.com/en/183/), [map](https://docs.coveo.com/en/217/) the [metadata](https://docs.coveo.com/en/218/) that you want to use as attributes in rules to the corresponding [fields](https://docs.coveo.com/en/200/). These [fields](https://docs.coveo.com/en/200/) must have the **Facet** or **Multi-value facet** option enabled. For example, to use the `color` [metadata](https://docs.coveo.com/en/218/) as an attribute in a rule, [map](https://docs.coveo.com/en/217/) it to a [field](https://docs.coveo.com/en/200/) with the **Facet** or **Multi-value facet** option enabled. * [Create query pipelines](https://docs.coveo.com/en/o48e0216#storefront-associations-and-query-pipelines). * [Choose the correct property](https://docs.coveo.com/en/o6lb0453#property-and-locale-selectors) to ensure that your changes affect the intended listing pages. ## Create include rules To create include rules . In the CMH, access the **Product listings** manager. . From the navigation tabs, select **filter rules** and then click **Create filter rule**. . Under **This rule will apply to**, define the scope of the rule. .. **Locale**: Select the [locale](https://docs.coveo.com/en/p4tf0351/) that the include rule applies to. By default, a rule applies to all available [locales](https://docs.coveo.com/en/p4tf0351/). .. **Audiences**: Select the audience that the include rule will target. You can choose between predefined audience profiles or create custom profiles. You can only select one audience profile per rule. > **Important** > > The **Audience** option is currently in early access. > Contact your Customer Success Manager (CSM) to enable this option. *** **All visitors**: By default, the rule applies to all [visitors](https://docs.coveo.com/en/nbub9475/). *** **Device & technology**: Target [visitors](https://docs.coveo.com/en/nbub9475/) visiting a [storefront](https://docs.coveo.com/en/p33g0410/) using a specific device type. The device type is determined by the information sent by the [visitor](https://docs.coveo.com/en/nbub9475/)'s browser, not by the device's screen size. Available options are: **** **Desktop**: Encompasses desktop computers and laptops. **** **Mobile**: Encompasses all mobile phones. **** **Tablet**: Encompasses all tablets. *** **Visitor type**: Target the [visitors](https://docs.coveo.com/en/nbub9475/) who are logged into the [storefront](https://docs.coveo.com/en/p33g0410/) or those who aren't. *** **Your audiences**: Create a custom audience profile that you can reuse in other rules sharing the same [property](https://docs.coveo.com/en/p4ue0547/). After a custom audience profile is created, it can't be changed once the rule is published. If all rules containing a custom audience profile are deleted, the custom audience profile will no longer be available as an option when creating new rules. **** **Visitor URL**: Target [visitors](https://docs.coveo.com/en/nbub9475/) based on the URL of the [storefront](https://docs.coveo.com/en/p33g0410/) page they're on. **** **Referrer URL**: Target [visitors](https://docs.coveo.com/en/nbub9475/) based on the URL they came from before landing on the [storefront](https://docs.coveo.com/en/p33g0410/). > **Important** > > For URL-based audiences to function correctly with query parameters (such as campaign tracking parameters like `?brand=barca&model=sp&color=red`), you can pass the complete URL including query parameters to Headless or the Commerce API directly. > See [Navigating between pages (CSR)](https://docs.coveo.com/en/o7v87331/), [Build product listing pages (SSR)](https://docs.coveo.com/en/p25b0072/), and [Use the Commerce API directly](https://docs.coveo.com/en/p5je0317#retrieve-products-for-a-listing-page) for implementation details. .. [.initial]**listing page**: Choose whether the include rule applies to all listing pages or to one or more specific listing pages. *** To apply the include rule to all listing pages: .... Select **All listing pages**. You won't be able to select an operator or any specific listing pages. .... Click **Done**. *** To apply the include rule to specific listing pages: .... Select **Specific listing pages**. .... Select an **Operator**. ***** `Is`: This operator identifies listing pages that exactly match the specified value. For example, you can use it to create a rule that only targets the listing page `accessories`. ***** `Page name contains`: This operator identifies listing pages where the specified value is found within the full value of the listing page name. For example, you can use it to create a rule that targets all listing pages whose name contains the term `accessories`, including `Accessories|Bags` and `Accessories|Life Jackets`. ***** `Page URL contains`: This operator identifies listing pages where the specified value is found within the full value of the listing page URL. For example, you can use it to create a rule that targets all listing pages whose URLs contain the term `kayak`, including `sports.barca.group/plp/canoes-kayaks` and `sports.barca.group/plp/canoes-kayaks/kayaks/sea-kayaks`. .... Select one or more [.initial]**listing pages** that the include rule applies to. .... Click **Done**. . Under **Choose an action**, select [.initial]**include**. . Under **Attribute**, select the attribute on which you want to apply the include rule. For example, to include products based on their brand, select `ec_brand`. . Under **Operator**, select the [operator](https://docs.coveo.com/en/o2gc0008/) that you want to use. . Under **Value**, select one or more attribute values that you want to use to filter products. For example, to include products based on the `ec_brand` attribute, enter the brand value that you want to use as a filter, such as **Barca Sports**. . (Optional) To add more attribute-value pairs to the include rule, click **Add attribute** and repeat the process. . Click **Next: Review and publish**. . Review your rule configuration. > **Leading practices** > > Use the panel on the right to preview how the rule affects > the products on the listing page for a given [locale](https://docs.coveo.com/en/p4tf0351/). > > The preview is an approximate simulation that won't cover every scenario encountered in a live environment. . Click **Next: Publish**. . Under **Rule name**, enter a meaningful name for your rule. . Under **Choose when to publish**, select one of the following: ** To apply the rule immediately, select **Publish now**. ** To set a schedule for the rule, select **Set a schedule**, and then select the time frame in which the rule should apply. . Click **Publish now**. The rule now applies or will apply as scheduled. ## Modify include rules To modify include rules . In the CMH, access the **Product listings** manager. . From the navigation tabs, select **filter rules**. . Locate the rule that you want to modify. . Click [dots], and then click **Modify**. . You can modify the rule's scope (**Locale**, **Audiences**, or [.initial]**listing page**) or its configuration by clicking **Edit** on the relevant card. These are the same settings covered in the [rule creation](#create-include-rules) section. > **Important** > > The **Audience** option is currently in early access. > Contact your Customer Success Manager (CSM) to enable this option. . When you've finished editing the rule, or to modify its publishing settings, click **Next: Publish**. . Update the publishing settings, if applicable, and then click **Publish now**. The modified rule now applies, or will apply as scheduled. ## Copy include rules To copy include rules . In the CMH, access the **Product listings** manager. . From the navigation tabs, select **filter rules**. . Locate the rule that you want to copy. . Click [dots], and then click **Copy to...**. . In the **Copy rule** modal that opens, you can choose whether to copy the rule to other [properties](https://docs.coveo.com/en/p4ue0547/) or listing pages. If the rule applies to all listing pages, you won't see the option to copy the rule to other listing pages. ** To copy the rule to other [properties](https://docs.coveo.com/en/p4ue0547/): ... Select **Property** and click **Next**. ... Use the dropdown menu to select one or more [properties](https://docs.coveo.com/en/p4ue0547/). > **Important** > > If the rule is scoped to one or more listing pages that > don't exist in the target [property](https://docs.coveo.com/en/p4ue0547/), you'll see an error message and be unable to proceed with the copy. > > The error message will list the listing pages that are missing from the destination [property](https://docs.coveo.com/en/p4ue0547/). ... Click **Confirm copy**. ** To copy the rule to other listing pages (if applicable): ... Select [.initial]**listing page** and click **Next**. ... Use the dropdown menu to select one or more listing pages. ... Click **Confirm copy**. The rule is copied to the target [properties](https://docs.coveo.com/en/p4ue0547/) or listing pages. ## Delete include rules To delete include rules . In the CMH, access the **Product listings** manager. . From the navigation tabs, select **filter rules**. . Locate the rule that you want to delete. . Click [dots], and then click **Delete**. . Click **Delete** again to confirm. The rule is deleted.