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

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Zing computes document scores using three components

# Zing computes document scores using three components {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 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 Zing computes document scores using three components

The Zing search engine calculates document relevance scores for search queries by evaluating three main components: frequency of search terms, sequence of terms, and the weight of the fields where terms appear.
This scoring approach helps ServiceNow customers optimize search results for better accuracy and relevance.
Show full answer Show less  

## Key Features

* **Frequency Points:** Zing awards one point for each occurrence of a search term in a document. For example, if the terms "distributed," "database," and "server" appear multiple times, their total counts contribute to the frequency score.
* **TF-IDF Enhancement:** By enabling term frequency--inverse document frequency (TF-IDF), Zing increases the impact of terms that appear frequently in a specific document but less frequently across the entire document set. This helps highlight more relevant, less common terms.
* **Sequence Points:** Zing assigns exponentially higher scores when search terms appear in the exact order as in the query. The scoring formula is 10 raised to the number of sequential terms, multiplied by the field weight. For instance, a three-term exact phrase scores 10³ (1000) points per occurrence.
* **Field Scoring Weights:** Each field has an associated tsweight attribute that multiplies the frequency and sequence scores. Critical fields like Knowledge record numbers and task numbers have higher default weights (e.g., 50), enhancing their influence on the total score. Most other fields have a default weight of 1, with a maximum possible weight of 255.

## Practical Impact for ServiceNow Customers

* Understanding how Zing scores documents enables customers to fine-tune search configurations, such as enabling TF-IDF or adjusting field weights, to improve search relevancy.
* Higher weighted fields ensure that key identifiers and descriptions meaningfully impact search rankings, making it easier for users to find the most relevant records quickly.
* Sequence scoring rewards exact phrase matches, encouraging precise query formulation and delivering more accurate search results.
* Overall, these scoring components work together to provide a balanced, relevance-driven search experience across ServiceNow tables and records.  
The Zing search engine computes document scores based on the frequency, sequence, and weight of search terms in the document.

## Document scores

The components of a document score for a search query are:

* Frequency: how often the search terms appear in the document.
* Sequence: how often the search terms appear in the same order as the search query.
* Weight: how heavily weighted the source field is in which the search terms appear.
{#c_DocumentScoring__ul_ynr_mlj_dq}  
Figure 1. Sample document score computation

## Frequency points

Zing awards one point whenever a search term appears anywhere in the document. For example, when searching for <kbd class="ph userinput">distributed database server</kbd>, a document that contains `distributed` three
times, `database` five times, and `server` 17 times would have 25 frequency points.

To increase search result scores of search terms that appear more frequently in a document, but less frequently in a document set, you can [Score search terms by inverse document frequency (IDF)](https://www.servicenow.com/docs/tJPbxzUQEuHckPG5g3K3Wg "Enable term frequency–inverse document frequency (TF-IDF) to increase the search result scores of search terms that appear more frequently in a document, but less frequently in the whole collection of searchable documents."). When TF-IDF is enabled, search term scores are calculated by multiplying the term frequency score by the inverse document frequency score. Because enabling TF-IDF increases the weight of less
common search terms, search results for that table are more likely to be relevant. For example, when searching for <kbd class="ph userinput">distributed database server</kbd>, the term `distributed` might receive a higher
score than `server` if it appears frequently in one document but less frequently in the document set as a whole.

Zing applies a multiplier to frequency points based on the value of the ts_weight attribute for the field in which the search term appears. A field with a text search scoring weight of 30
(ts_weight=30) would add 30 points for each inclusion of a search term.

## Sequence points

Zing awards a document more points when it contains the search terms in the same order in which they were typed. The more search terms in sequence there are, the exponentially higher the score becomes. Zing awards sequence
points as 10\^x, where x is the number of search terms that appear in sequence.

In the <kbd class="ph userinput">distributed database server</kbd> search example, Zing awards a document 100 (10\^2) sequence points for each time it includes the two-term string <kbd class="ph userinput">database server</kbd>. Likewise, Zing
awards a document 1000 (10\^3) sequence points each time it includes the three-term string <kbd class="ph userinput">distributed database server</kbd>.

Zing applies a multiplier to sequence points based on the value of the ts_weight attribute for the field in which the sequence appears. The sequence points use the calculation (10\^x \* field
ts_weight attribute).

## Field scoring weights

The system elevates the default scoring weight of Knowledge record numbers, Knowledge short descriptions and metadata, task record numbers, and task short descriptions. Default ts_weight attributes for these fields are as follows:

* kb_knowledge.number = 50
* kb_knowledge.short_description = 10
* kb_knowledge.meta = 10
* task.number = 50
* task.short_description = 10
{#c_DocumentScoring__ul_exv_lmj_dq}

All other fields have a default ts_weight attribute of 1. The maximum possible weight value is 255.
* **[Score search terms by inverse document frequency (IDF)](https://www.servicenow.com/docs/tJPbxzUQEuHckPG5g3K3Wg)**   
  Enable term frequency--inverse document frequency (TF-IDF) to increase the search result scores of search terms that appear more frequently in a document, but less frequently in the whole collection of searchable documents.
* **[Set the relative weight of a field](https://www.servicenow.com/docs/s5Gn~YHAP4FdotbFQDfUUA)**   
  To improve search results, the Zing search engine assigns to each potential match a numeric score that represents its relevancy to the query.

**Related concepts**   

* [Available search options](https://www.servicenow.com/docs/koIRY3M_3ZFvUUaLXnD46w "Zing offers users several search interfaces and search operators to conduct text searches.")
* [Global search finds records from multiple tables](https://www.servicenow.com/docs/znpIbUtYQWF5OAFSjpMhAQ "Search multiple record types from a single search field.")
* [Zing generates search results in four phases](https://www.servicenow.com/docs/ErLN5oVzrUC4Gbc0Ehb~bg "Generate search results by dividing documents among shards, searching shard documents, scoring shard documents, and merging scores into an index.")
* [Zing filters search results with access controls](https://www.servicenow.com/docs/Y15twPO3q0E1CQeRL3Dbsg "Zing filters search results to only display records the user can access.")
* [Zing indexes words](https://www.servicenow.com/docs/LAWI_0XHmB8iRfSnR1xFIw "Index documents by dividing them into words. Depending on the languages your instance supports, a word may be a single character such as a Chinese or Japanese pictogram or a sequence of characters separated by spaces such as with Latin, Arabic, and Pinyin languages.")
* [Zing can include attachments in search results](https://www.servicenow.com/docs/rW9qOAn0vw4lpLwyoxboHw "Search content from attachments on indexed tables. Display attachments for search results from the Knowledge [kb_knowledge] table.")
* [Zing removes stop words from queries](https://www.servicenow.com/docs/Py_nS9cHmcX~sNzUo7eUGA "Remove common words from search queries that don't produce meaningful results.")
* [Zing matches derived words with stemming](https://www.servicenow.com/docs/4odcR89Yv7tcaRngq1gS3A "Convert any multiple-character search keyword to its stem form to find derived versions of the word.")
* [Zing can expand search results with synonyms](https://www.servicenow.com/docs/tdKjEpAhTILDgRPHRhPtYg "Expand search results to include additional search terms.")
* [Zing displays search suggestions as users enter search terms](https://www.servicenow.com/docs/LZiSPp6KuQcei7zwPUkYig "Display possible search query completions as users enter search terms.")  
**Related reference**   

* [Features of Zing text indexing and search engine](https://www.servicenow.com/docs/LkyQr4d9dRk~Wy654Ry98Q "Enable and configure Zing text indexing and search engine features.")
* [Installed with Zing](https://www.servicenow.com/docs/AkzGatM~y53SRTG6YHPNtg "Several types of components are installed with Zing.")

