---
sourceDocument: Australia ServiceNow AI Platform Administration
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/platform-administration

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Rule - Action Mapping form

# Rule - Action Mapping form {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Rule - Action Mapping form

The Rule - Action Mapping form in AI Search enables ServiceNow customers to link a boost action to a result improvement rule within a search profile.
This setup helps customize how search results are ranked by applying relevancy boosts based on specific criteria, enhancing the search experience by prioritizing more relevant results.
Show full answer Show less  

## Key Features

* **Label:** Define a unique identifier for each boost action to manage and reference easily.
* **Type and Application:** Automatically set fields indicating the action is a Boost Action and scoped to the current application.
* **Order:** Specify the evaluation order of boost actions within a result improvement rule to control their application sequence.
* **Boost Type:** Choose from several boosting strategies:
  * **Boost All Documents In Indexed Source:** Applies a relevancy boost universally to all results from a selected source.
  * **Boost By User Context (dynamic):** Applies boosts dynamically when search results match user context values, such as language preferences.
  * **Boost By Field Match (static):** Applies boosts based on static field value matches in search results.
  * **Boost By Synonym Dictionary:** Uses synonym dictionaries to boost results that match synonym values for a selected field.
* **Indexed Source:** Targets the boost action to search results from a specific indexed data source.
* **Boost Weight:** Controls the magnitude and direction of relevancy modification, with positive values increasing and negative values decreasing relevancy scores. The boost weight directly adjusts the relevancy percentage, allowing fine-grained influence on search result rankings. Multiple boost actions on a single result sum their weights for a combined effect.
* **Conditional Fields:** Depending on the boost type selected, additional fields appear to specify:
  * **When:** The indexed source field to evaluate.
  * **Matches:** For dynamic user context, the user context element to compare.
  * **Contains:** For static matches, the specific value to compare against.
  * **A Synonym Dictionary:** The synonym dictionary to use for matching.

## Practical Application

ServiceNow customers can use the Rule - Action Mapping form to tailor AI Search relevancy behavior by creating boost actions linked to result improvement rules. This flexibility allows prioritizing search results based on user context, static values, or synonyms, improving the accuracy and usefulness of search outcomes in their ServiceNow environments.  
The Rule - Action Mapping form enables you to link a boost action to a result improvement rule in an AI Search search profile.
For information on configuring boost actions in result improvement rules, see [Boost search results using a result improvement rule](https://servicenow-prod.fluidtopics.net/10sVBV2oii_gzVzmg38rfw#boost-results-ais "Increase the relevancy scores for search results that satisfy a custom set of conditions.").  
{#rule-action-map-form-ais__table_ksn_hqd_2nb__entry__2}{#rule-action-map-form-ais__boost-weight-relevancy-scores-p-3}

| Field | Description |
|-|-|
| Label | Unique label for the boost action. |
| Type | Action type. This field is automatically set to Boost Action. |
| Application | Application scope for the boost action. This field is automatically set to the name of the current application. |
| Order | Order of evaluation for the boost action in the context of the result improvement rule. |
| Boost Action ||
| Boost Type | Type of boost the action applies to search results from the selected indexed source. Supported types include: * Boost All Documents In Indexed Source: Applies relevancy boost to every search result from the indexed source. * Boost By User Context (dynamic): Applies relevancy boost to search results from the indexed source if they include a value for the selected field that matches a field value specified in the dynamically populated user context. * Boost By Field Match (static): Applies relevancy boost to search results from the indexed source if they include a value for the selected field that matches a specified static value. * Boost By Synonym Dictionary: Applies relevancy boost to search results from the indexed source if they include a value for the selected field that matches any synonym defined in a synonym dictionary. {#rule-action-map-form-ais__ul_sld_swk_wxb} |
| Indexed Source | Reference to an indexed source. The boost action only applies to search results for records from this indexed source. |
| Boost Weight | Integer value that AI Search uses to alter the relevancy scores for search results affected by the boost action. Boost weights can be positive or negative. Positive boost weights increase the relevancy scores for boosted search results. Each boost weight of 1 increases a boosted search result's relevancy score by 0.1% of its original value. For example, if you set a boost weight of 100, you increase each boosted search result's relevancy by +10%, so a search result with an original relevancy score of 60 gets a final relevancy score of 66. Setting a boost weight of 1000 adds +100%, doubling the relevancy scores for boosted search results.{#rule-action-map-form-ais__boost-weight-relevancy-scores-p-1} Negative boost weights reduce the relevancy scores for boosted search results. Each boost weight of --1 reduces a boosted result's relevancy score by 0.1% of its original value. As an example, if you set a boost weight of --150, you reduce a boosted search result's relevancy by 15%, so a search result with an original relevancy score of 100 gets a final relevancy score of 85. Any boost weight of --1000 or lower reduces a boosted search result's relevancy score to 0, causing it to appear at the end of the search result list.{#rule-action-map-form-ais__boost-weight-relevancy-scores-p-2} When a single search result is affected by multiple boost actions, AI Search adds the individual boost weights together to determine the total relevancy score modifier. For example, a search result boosted by three rules with boost weights 100, 150, and --25 has a total boost weight of 225, increasing its final relevancy score by 22.5% of its original value. |
| When | Name of a field from the selected indexed source. This field appears only when you select Boost By User Context (dynamic), Boost By Field Match (static), or Boost By Synonym Dictionary as the boost type. |
| Matches the Searcher's | Dynamically populated user context element to compare with a search result's value for the field selected in the When field. This field appears only when you select Boost By User Context (dynamic) as the boost type. The choice list displays the source table and field for each user context element. As an example, the Language user context element is populated using the User \[sys_user\] table's language field value for the search user. |
| Contains | Static value to compare with a search result's value for the field selected in the When field. This field appears only when you select Boost By Field Match (static) as the boost type. |
| Matches A Synonym Dictionary | Synonym dictionary to check for synonyms that match a search result's value for the field selected in the When field. This field appears only when you select Boost By Synonym Dictionary as the boost type. |
[Table 1. Rule - Action Mapping form]

{#rule-action-map-form-ais__table_ksn_hqd_2nb}