---
sourceDocument: Zurich ServiceNow AI Platform Administration
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-administration

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Promote search results using a result improvement rule

# Promote search results using a result improvement rule {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Configure a result improvement rule to make specific records appear first in results for a search.

## Before you begin

Create your result improvement rule first to define your trigger conditions. For steps to create a result improvement rule, see [Create a result improvement rule](https://www.servicenow.com/docs/7yexgw~HFOWb6Jy2KepFkA "Create a rule to boost, block, or promote search results or to block Genius Results. Specify the conditions that activate your rule and choose the action it performs when activated.").

Role required: ais_admin

## About this task

Promote actions define search results to spotlight in the result set. When a result improvement rule with a promote action activates, it displays search results specified in the action ahead of other results for the search
query.  
Note:  
Promote actions can spotlight results that wouldn't otherwise match your search. Spotlighted results are added to the search results set if they're not already present in it.

## Procedure

1. In the Actions related list, select Promote Documents.
2. In the Select Documents To Promote dialog box, search for the results that you want to promote.
3. To add a search result to the selected results pane, select the plus sign next to it.
4. After selecting all the results that you want to promote, select Add Documents and Close.
5. **Optional:** Edit the Order values for the result improvement rule's promote actions.  
   The Order field only accepts integer values. AI Search evaluates promote actions with lower Order values before promote actions with higher values. As an example, a promote action with Order 150 is evaluated before one with Order 200.

## What to do next

To make new or updated result improvement rule settings take effect, publish the search profile that you edited. For details on publishing a search profile, see [Publish an AI Search search profile](https://www.servicenow.com/docs/KEjtTYmbZH6icW~9TzncfA "Publish a search profile to make pending changes to its settings take effect in linked search applications.").