--- title: Spotlight content rules for search slug: q2ob5343 canonical_url: https://docs.coveo.com/en/q2ob5343/ collection: coveo-merchandising-hub source_format: adoc --- # Spotlight content rules for search > **Important** > > Contact your Coveo representative to enable spotlight content rules in your [Coveo organization](https://docs.coveo.com/en/185.md). In the [Search manager](https://docs.coveo.com/en/p63f0210.md) of the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573.md), merchandisers can define _spotlight content_ ranking rules to insert non-product content into specific positions in the search results for one or more [queries](https://docs.coveo.com/en/231.md). ![Spotlight content rule configuration in Search | Coveo Merchandising Hub](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-search-spotlight-content-rule.png) ## Use case examples Spotlight content ranking rules help address a variety of use cases. Examples include: * **Spotlight product-related information**: Provide a link to a page with information about a particular product category, such as a buying guide or a sizing guide. * **Spotlight a specific brand**: Provide a link to a [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187.md) that only shows products from a specific brand. * **Spotlight a site-wide campaign**: Provide a link to a page with information about a site-wide promotion or campaign, such as free shipping or a list of payment options. ## Spotlight content and pins Spotlight content rules can affect the visual merchandising of your search results by changing the order of the numbered positions that are reserved by [pin rules](https://docs.coveo.com/en/o5sf0402.md). Although spotlight content can't come into direct [conflict with a pin](https://docs.coveo.com/en/o5sf0402.md#pin-rule-conflicts), it will “push” a pinned product in a numbered position over from its expected output in the search results. These rules don't reserve specific numbered positions in the search results because spotlight content isn't considered a product and doesn't have a product ranking. Instead, a spotlight content rule creates a new unnumbered position before a particular numbered position and “pushes” the numbered position over by one. That numbered position keeps its ranking number. **Example** The pass:q,a[search results for the query `fish finder` include] the following products in these numbered positions: [%header,cols="^1,^1,^1,^1"] |=== |1 |2 |3 (reserved) |4 |`FishDarmin` |`Gpshum` |`Navify` |`Lowrance` |=== The `Navify` fish finder is a product that's pinned at position 3. You create a spotlight content rule that inserts a fish finder buying guide before product 3. This creates a new unnumbered position between positions 2 and 3. [%header,cols="^1,^1,^1,^1"] |=== |1 |2 | |3 (reserved) |`FishDarmin` |`Gpshum` |Fish finder buying guide |`Navify` |=== The `Navify` fish finder is still pinned at position 3, but in the search results, the buying guide is the third item and the `Navify` fish finder is the fourth item. ## Prerequisites Before you create rules in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573.md): * [Create query pipelines](https://docs.coveo.com/en/o48e0216.md#storefront-associations-and-query-pipelines). * [Choose the correct property](https://docs.coveo.com/en/o6lb0453.md#property-and-locale-selectors) to ensure that your changes affect the intended queries. ## Create spotlight content rules To create spotlight content rules . In the CMH, select **Search**. . 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.md) that the spotlight content rule applies to. By default, a rule applies to all available [locales](https://docs.coveo.com/en/p4tf0351.md). .. **Audiences**: Select the audience that the spotlight content 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.md). *** **Device & technology**: Target [visitors](https://docs.coveo.com/en/nbub9475.md) visiting a [storefront](https://docs.coveo.com/en/p33g0410.md) using a specific device type. The device type is determined by the information sent by the [visitor](https://docs.coveo.com/en/nbub9475.md)'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.md) who are logged into the [storefront](https://docs.coveo.com/en/p33g0410.md) 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.md). 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.md) based on the URL of the [storefront](https://docs.coveo.com/en/p33g0410.md) page they're on. **** **Referrer URL**: Target [visitors](https://docs.coveo.com/en/nbub9475.md) based on the URL they came from before landing on the [storefront](https://docs.coveo.com/en/p33g0410.md). .. [.initial]**query**: Choose whether the spotlight content rule applies to all queries or to one or more specific queries. *** To apply the spotlight content rule to all queries: .... Select **All queries**. You won't be able to select an operator or any specific queries. .... Click **Done**. *** To apply the spotlight content rule to specific queries: .... Select **Specific queries**. .... Select an **Operator**. ***** `Is`: This operator identifies queries that exactly match the specified value. For example, you can use it to create a rule that only targets the query `accessories`. ***** `Contains`: This operator identifies [queries](https://docs.coveo.com/en/231.md) where the specified value is found within the full value of the [query](https://docs.coveo.com/en/231.md). For example, you can use it to create a rule that targets all [queries](https://docs.coveo.com/en/231.md) containing the term `accessories`, including `Surf accessories` and `Parts & accessories`. .... Select one or more [.initial]**queries** that the spotlight content rule applies to. .... Click **Done**. . Under **Choose an action**, select **Spotlight content**. . On the **Layout** card, select the position in which you want to insert the spotlight content. This position is relative to a particular product. For example, if you want the spotlight content to appear in the third position in the search results for the queries you selected, insert it before product 3. . On the **Assets** card, define the spotlight content that you want to insert: .. Under **Desktop image**, enter the URL of an image that you want users on desktop browsers to see. Check the **Use same image for mobile** box if you want desktop and mobile users to see the same image. .. (Optional) Under **Mobile image**, enter the URL of an image that you want users on mobile browsers to see. .. Under **URL**, enter the address to which you want to send users when they click the spotlight content. .. (Optional) Under **Heading**, enter a heading or title for your spotlight content. .. (Optional) Under **Subheading**, enter any other text that you want to appear with your spotlight content. . Click **Next: Review and publish**. . Review your rule configuration. > **Leading practices** > > Use the panel on the right to preview how the rule affects > the search results for a given [locale](https://docs.coveo.com/en/p4tf0351.md). > > 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 spotlight content rules To modify spotlight content rules . In the CMH, select **Search**. . 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]**query**) or its configuration by clicking **Edit** on the relevant card. These are the same settings covered in the [rule creation](#create-spotlight-content-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 spotlight content rules To copy spotlight content rules . In the CMH, select **Search**. . From the navigation tabs, select **ranking 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.md) or queries. If the rule applies to all queries, you won't see the option to copy the rule to other queries. ** To copy the rule to other [properties](https://docs.coveo.com/en/p4ue0547.md): ... Select **Property** and click **Next**. ... Use the dropdown menu to select one or more [properties](https://docs.coveo.com/en/p4ue0547.md). > **Important** > > If the rule is scoped to one or more queries that > don't exist in the target [property](https://docs.coveo.com/en/p4ue0547.md), you'll see an error message and be unable to proceed with the copy. > > The error message will list the queries that are missing from the destination [property](https://docs.coveo.com/en/p4ue0547.md). ... Click **Confirm copy**. ** To copy the rule to other queries (if applicable): ... Select [.initial]**query** and click **Next**. ... Use the dropdown menu to select one or more queries. ... Click **Confirm copy**. The rule is copied to the target [properties](https://docs.coveo.com/en/p4ue0547.md) or queries. ## Delete spotlight content rules To delete spotlight content rules . In the CMH, select **Search**. . 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.