Zing computes document scores using three components

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
  • Summarize
    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 relevancy scores based on three key factors: frequency, sequence, and weight of search terms within documents. This scoring methodology helps ServiceNow customers refine search result relevance and improve user experience when querying large data sets.

    Show full answer Show less

    Key Features

    • Frequency: Points are awarded based on how often each search term appears in a document. For example, if the terms “distributed,” “database,” and “server” appear multiple times, each occurrence contributes to the frequency score.
    • Sequence: Additional points are given when search terms appear in the exact order as the query. The scoring grows exponentially with the length of the matching sequence (10^x, where x is the number of sequential terms), emphasizing phrase matching.
    • Weight: Each field containing search terms has a configurable scoring weight (tsweight) that multiplies frequency and sequence points, allowing important fields like Knowledge record numbers or task numbers to have higher impact on the score.
    • TF-IDF Integration: Enabling term frequency–inverse document frequency (TF-IDF) adjusts scores to favor terms that are frequent in a document but rare across the entire document set, thus improving search relevance for distinctive terms.

    Field Scoring Weights

    Default weights highlight important fields to prioritize their search hits:

    • Knowledge record number: 50
    • Knowledge short description and metadata: 10
    • Task record number: 50
    • Task short description: 10
    • All other fields default to 1

    The maximum weight value is 255, enabling fine-tuning of search behavior based on business priorities.

    Practical Benefits for ServiceNow Customers

    • Improved search result relevance through combined scoring of term frequency, order, and field importance.
    • Ability to fine-tune search weighting per field to elevate critical content like knowledge articles or task records.
    • TF-IDF scoring support that enhances the prominence of distinctive search terms, increasing the accuracy of search results.
    • Exponential scoring for sequential terms that boosts results with exact phrase matches, which is useful for precise query needs.

    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.
    Figure 1. Sample document score computation
    Graphic showing frequency and sequence scoring for sample search query and document.

    Frequency points

    Zing awards one point whenever a search term appears anywhere in the document. For example, when searching for distributed database server, 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). 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 distributed database server, 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 distributed database server search example, Zing awards a document 100 (10^2) sequence points for each time it includes the two-term string database server. Likewise, Zing awards a document 1000 (10^3) sequence points each time it includes the three-term string distributed database server.

    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

    All other fields have a default ts_weight attribute of 1. The maximum possible weight value is 255.