--- sourceDocument: Xanadu ServiceNow AI Platform Administration sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/platform-administration Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Result improvement rules # Result improvement rules {#ariaid-title1} * Release version: Xanadu * * Updated August 1, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Define rules with configurable trigger conditions to boost, block, or promote search results for specific searches. You can also boost search results for documents matching elements of the user context, such as a user's country, OS, or device type. Result improvement rules with boost actions override the default search result order produced by the AI Search machine learning relevancy feature. Rules with block or promote actions override the default result set for a search query. ## Rule structure {#result-improvement-rules-ais__section_st4_gyq_gnb} A result improvement rule consists of these parts: * A set of conditions that determine when the rule activates. * A set of boost, block, or promote actions that determine how the rule modifies the search query's results when activated. The rule can only include actions of a single type, but can include multiple actions of that type. {#result-improvement-rules-ais__ul_ybq_hyq_gnb} Rule conditions include the following: * A date range bounded by start and end dates. The rule can only activate during the specified date range. * A language. The rule can only activate if this language matches the search query's language. * Optionally, a set of one or more trigger conditions. Triggers can operate on individual search query keywords, the full search query, or elements of the search user's context such as their department, language, or browser version. The rule can only activate if all of its trigger conditions are met. {#result-improvement-rules-ais__ul_hrk_tyq_gnb} Rule actions include the following types: * Boost: Increase the relevancy scores for search result records that include specific field values. You can use either of the following options: * Boost search result records that include field values matching a dynamically populated value from the user context. * Boost search result records that include field values matching a static value that you specify. {#result-improvement-rules-ais__ul_fdn_jcn_mnb} * Block: Exclude specific records from the search query's results. * Promote: Display specific records at the start of the search query's results. {#result-improvement-rules-ais__ul_hck_dzq_gnb}Each result improvement rule can only perform actions of a single type when activated. You can define multiple actions of the same type for a rule. Block actions take precedence over promote actions. If two rules block and promote the same record, AI Search excludes the record from the search query's results. ## Language dependence {#result-improvement-rules-ais__section_dvg_gxq_gnb} Result improvement rule activation is language-dependent. You specify a language for each result improvement rule. AI Search supports result improvement rules for all languages activated in your instance. For the list of languages you can activate, see [Activate a language](https://www.servicenow.com/docs/JVX9OJGGemU7rGe1QNjBRw "By default, the language supported by the platform is American English. You can activate plugins for other supported languages if you have the admin role."). ## Interaction with other search features {#result-improvement-rules-ais__section_p3f_wsy_2nb} The following table describes interactions between result improvement rules with Query triggers and other search features. {#result-improvement-rules-ais__table_vdr_yd5_fnb__entry__2} | Feature | Interaction with result improvement rules | |-|-| | [Lemma and Unicode normalization](https://www.servicenow.com/docs/dtWWHHYDmYUsOuASp_0jvg "AI Search normalizes inflected words and Unicode glyphs during indexing and at search query time. Normalization improves search recall and enables users to find content with variant forms of their search query terms.") | A search query term added by lemma or Unicode normalization can trigger a result improvement rule if it matches the rule's Query trigger. | | [Stop words](https://www.servicenow.com/docs/Cim4Rf8qhGT64T_dt2XUZA "Stop words remove search query terms that don't produce meaningful results. Improve search precision and relevancy by configuring stop word dictionaries and defining stop words.") | If a search query term that matches a result improvement rule's Query trigger is defined as a stop word, AI Search evaluates the rule trigger before removing the stop word from the search query. | | [Synonyms](https://www.servicenow.com/docs/cjrGZ8bePEfjKrApMpyYnQ "Synonyms expand search queries to include additional terms with equivalent meaning or usage. Improve search recall by configuring synonym dictionaries and defining synonyms.") | By default, a synonym expansion term can activate a result improvement rule if it matches the rule's Query trigger. You can prevent synonym expansion terms from activating a rule with a Query trigger by clearing the Expand Synonyms For Query Conditions option that appears when you define the Query trigger. | | [Typo handling](https://www.servicenow.com/docs/pmfC8lQxxBx7TjVN98~VRA "AI Search replaces misspelled search query terms with auto-correction terms derived from indexed content. Configure typo handling dictionary settings to control derivation of auto-correction terms.") | An auto-corrected search query term can trigger a result improvement rule if it matches the rule's Query trigger. | [ ] {#result-improvement-rules-ais__table_vdr_yd5_fnb} * **[Create a result improvement rule](https://www.servicenow.com/docs/5KpVzDdsvJ9~HKp1jqZuJw)** 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. * **[Boost search results using a result improvement rule](https://www.servicenow.com/docs/xs8NxrwynsO6luNMgHxqeA#boost-results-ais)** Increase the relevancy scores for search results that satisfy a custom set of conditions. * **[Block search results and Genius Results using a result improvement rule](https://www.servicenow.com/docs/JfXOpVpFkLt5Ea8d22gX7g)** Configure a result improvement rule to prevent specific documents from appearing as Genius Results or search results. * **[Promote search results using a result improvement rule](https://www.servicenow.com/docs/Q2qSKQPTKVWxU7zhSALY8Q)** Configure a result improvement rule to make specific records appear first in results for a search. * **[Share result improvement rules between search profiles](https://www.servicenow.com/docs/irEvyjmi2bqYTA7aiISGpQ)** Make your search experiences more consistent by configuring a search profile to mirror result improvement rules from other search profiles.