--- title: Pin rules for slots slug: o8rk8516 canonical_url: https://docs.coveo.com/en/o8rk8516/ collection: coveo-merchandising-hub source_format: adoc --- # Pin rules for slots In the [Recommendations manager](https://docs.coveo.com/en/p65f5021/) of the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/), merchandisers can define _pin_ ranking rules to make specific products appear in specific positions in [recommendation slots](https://docs.coveo.com/en/o9b80563/). However, multiple pin rules with the same target can [conflict with one another](#pin-rule-conflicts). ![Pin rule for recommendation slots | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-recs-pin-rule.png) ## Use case examples Pin ranking rules can be used to address a variety of use cases. Here are a few examples: * **Enforce a specific order**: Pin products to specific locations in the recommendation slot to enforce a specific order. * **Pin clearance items**: Pin clearance items to the top of a recommendation slot to increase their visibility. ## Pin rule conflicts Pin rules override the content that should otherwise appear at a specific position in a [recommendation slot](https://docs.coveo.com/en/o9b80563/). This includes other pin rules that target the same position, so merchandisers must not create multiple pin rules that target the same position in the same [slot](https://docs.coveo.com/en/o9b80563/). If there's a conflict between pins, priority is given to the most recent pin rule. **Example** On March 1, you create a rule that pins the product "Safari Khakis" at position 2 in the recommendation slot on the [product detail page (PDP)](https://docs.coveo.com/en/n8ad7392/) for `Chinos`. On March 10, you create another rule that pins the product "Blue Jeans" at position 2 in the recommendation slot on the [product detail page (PDP)](https://docs.coveo.com/en/n8ad7392/) for `Chinos`. Because both pin rules target the same position in the same recommendation slot, only the most recent rule applies. When a user views the [product detail page (PDP)](https://docs.coveo.com/en/n8ad7392/) for `Chinos`, "Blue Jeans" is pinned at position 2 in the recommendation slot. ## Prerequisites Before you create rules in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/): * [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 slots. ## Create pin rules To create pin rules . In the CMH, access the **Recommendations** manager. . From the navigation tabs, select **ranking rules** and then click **Create ranking 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 pin rule applies to. By default, a rule applies to all available [locales](https://docs.coveo.com/en/p4tf0351/). .. [.initial]**slot**: Select the recommendation slot that the pin rule applies to, and then click **Done**. > **Note** > > Currently, ranking rules can only apply to a specific recommendation slot. . Under **Choose an action**, select **Pin**. . To pin a product, you can either search for the product or use the preview to select the products to pin. ** To search for a product: ... Under **Product ID or name**, select the product to pin. ... Under **Position number**, enter the number of the position where the product will appear in the recommendation slot. ... (Optional) To pin more than one product, click **Pin another product** and repeat the previous steps. ** When using the preview, drag a product and drop it at a position to pin it there. If you selected a slot that requires a [seed product](https://docs.coveo.com/en/n5jg0219/) to generate recommendations, you must select a seed product to preview the recommendations generated for the selected products. . For a recommendation slot using a [seeded strategy](https://docs.coveo.com/en/o9ge0347/), under **Choose when to apply**, select whether you want the rule to apply in any situation, or only if [specific conditions are met](https://docs.coveo.com/en/o4nh0046#conditional-filter-and-ranking-rules). . 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 in the recommendation slot for a given [locale](https://docs.coveo.com/en/p4tf0351/). > > If you're previewing a rule for a recommendation slot using a [seeded strategy](https://docs.coveo.com/en/o9ge0347/), you must choose the products for which you want to simulate recommendations to see the effect of the rule. > > 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 pin rules To modify pin rules . In the CMH, access the **Recommendations** manager. . From the navigation tabs, select **ranking 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]**slot**) or its configuration by clicking **Edit** on the relevant card. These are the same settings covered in the [rule creation](#create-pin-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. ## Delete pin rules To delete pin rules . In the CMH, access the **Recommendations** manager. . From the navigation tabs, select **ranking rules**. . Locate the rule that you want to delete. . Click [dots], and then click **Delete**. . Click **Delete** again to confirm. The rule is deleted.