Product Selector

Fusion 5.12
    Fusion 5.12

    Boost Documents Stage

    Table of Contents

    The Boost Documents query pipeline stage adds boosting parameters to matched documents based on user-defined rules. Boosts are defined with a term value to boost and the boost factor to add. The boosting parameters are added to the bq Solr query parameter.

    The Boost Documents rule consists of the following elements:

    • field. The document field to filter on.

    • keywords. The words, phrases, or regex used as the filter.

    • mode. Filtering logic applied to keywords, one of:

      • exact. The keyword and the query must match exactly. This is case-sensitive.

      • phrase. The phrase matching on the items in the keywords list.

      • regex. Treat items in the keywords list as a regex.

      • match. Must match every item in the keyword list, but does not require phrase matching.

    • boosts. Consists of a list of pairs.

      • value. One or more terms used for boosting.

      • boost. The numeric boost value. Default 100.


    When entering configuration values in the UI, use unescaped characters, such as \t for the tab character. When entering configuration values in the API, use escaped characters, such as \\t for the tab character.

    Boost calculation

    In Fusion 5.x.x, numbers entered into boosts are multiplied with the score.

    This differs from Fusion 4.x.x where numbers entered into boosts are added to the score.

    As a result of multiplication:

    • Negative boosts are not possible. You must use fractional values to deprioritize the score. For example, a boost value of 0.5 decreases the score by half.

    • Do not use values such as 100, which was considered reasonable in Fusion 4.x.x. If those values are entered in Fusion 5.x.x, document scores are boosted to an unrealistically high level.

    • Fusion generates an error when a query is executed on a pipeline that uses negative boost values.

    Boost results based on document or query

    skip - boolean

    Set to true to skip this stage.

    Default: false

    label - string

    A unique label for this stage.

    <= 255 characters

    condition - string

    Define a conditional script that must result in true or false. This can be used to determine if the stage should process or not.

    queryParam - string

    Default: q

    rules - array[object]

    object attributes:{keyword required : {
     display name: Keyword
     type: string
    mode required : {
     display name: Match Strategy
     type: string
    field required : {
     display name: Field
     type: string
    boosts : {
     display name: Boosts
     type: array