Prioritize results

Search uses widgets to display paginated results based on a search keyphrase. You can use variation rules to artificially change the order in which specific search results appear in widgets, for example, by boosting an item's priority or pinning it to a specific position in the results list.

To ensure that an item appears first in the results list, pin it to a slot. Boosted items will appear higher in search results, but are not guaranteed to appear first.

Important

If a content item is pinned, its slot remains occupied even after the content item is deleted, meaning fewer results are shown. To avoid this, remove the item pinned to a slot after deleting the item itself.

The following procedures describe how to prioritize results in your implementation of Search.

Important

To save a widget variation rule, you need to populate at least one of the following configurations:

Before you begin

Boost items

Using a widget variation to boost a specific attribute causes all results with that attribute to appear above others in search results. For example, setting the attribute color's boost value to red will cause all results that are red to appear higher in search results. Boosted items appear in slots where boost rules have been applied.

You can also boost results based on site or visitor context.

To boost items:

  1. On the menu bar, click Widgets.

  2. Click the widget that you want to apply a boost rule to.

  3. Click the widget variation that you want to apply a boost rule to.

  4. Select an existing rule, or click Add Rule.

  5. On the menu bar, click Strategies.

  6. In the left pane of the Strategies page, on the Boost Rules tab, click Add attribute.

  7. In the attributes drop-down list, select the attribute you want to boost.

  8. In the operator drop-down list, click Is.

  9. In the text box, enter an appropriate attribute value, and then click Save.

  10. On the Slots tab, click Widget Rules Puzzle or jigsaw piece that displays a list of available widget variation rules.

  11. In the drop-down list, click Boost.

  12. Click Save.

  13. To deploy, click Publish.

Tip

To additionally target results using the Strategies and Settings sections of a rule, you can configure the Site and Visitor tabs in the Context section.

Pin an item in a specific widget

When a pin rule is in effect in an Active widget variation, a chosen content item appears in the selected slot. In a widget variation rule, an item pinned to a slot displays a pin .

To pin an item in a specific widget:

  1. On the menu bar, click Widgets.

  2. Click the widget that you want to apply a pin rule to.

  3. Click the widget variation that you want to apply a pin rule to.

  4. Select an existing rule, or click Add Rule.

  5. On the menu bar, click Strategies.

  6. On the Slots tab, in the Content Items pane on the right-hand side, locate the content item you want to pin.

  7. Drag the item onto a slot to pin it.

  8. Click Save.

  9. To deploy, click Publish.

Pin an item in all widgets

In a global widget variation rule, an item pinned to a slot displays a pin .

If you also want to target results using the Strategies and Settings sections of a rule, you can configure the Site and Visitor tabs in the Context section.

To pin an item in all widgets:

  1. On the menu bar, click Global Resources.

  2. Click Global Widget.

  3. On the Global Widget Variations tab, click Add Variation and enter an appropriate name for the new variation.

  4. Turn on the Make this as a default variation switch and click Save.

  5. On the Rules tab, click Add Rule.

  6. On the menu bar, click Strategies.

  7. On the Slots tab, in the Content Items pane on the right-hand side, locate the content item you want to pin.

  8. Drag the item onto a slot to pin it.

  9. Click Save.

  10. To deploy, click Publish.

Boost a pinned item

You can boost an item that is already pinned, although doing so will remove the pin and free up the slot the item was occupying.

To switch from pinning an item to boosting an item:

  1. On the menu bar, click Widgets.

  2. Click the widget that you want to edit.

  3. Click the widget variation that you want to edit.

  4. Select the rule that you want to edit.

  5. On the menu bar, click Strategies.

  6. On the Slots tab, in the pinned item, click Pin .

  7. In the drop-down list, click Boost.

  8. Click Save.

  9. To deploy, click Publish.

Unpin an item

If you no longer want an item to be pinned in search results, you can remove it from its allocated slot.

To unpin an item:

  1. On the menu bar, click Widgets.

  2. Click the widget that you want to edit.

  3. Click the widget variation that you want to edit.

  4. Select the rule that you want to edit.

  5. On the menu bar, click Strategies.

  6. On the Slots tab, to open the slot drop-down menu, click Pin .

  7. Select the Personalized check box.

  8. Click Save.

  9. To deploy, click Publish.

Boost

A way to set the position of a particular item in search results that overrides other search filters. You can use this to highlight content that is important or relevant for your visitors or if you want to highlight a recommendation.

A way to exclude an item or a group of items from the search results, also called a blocklist. This is useful when you do not want to show certain items on a certain website or for specific visitors.

A way to decrease the relevance of the item or the group of items by making them appear lower in the search results. You can use this to reduce the visibility of certain content.

Do you have some feedback for us?

If you have suggestions for improving this article,