Condition boost specifications. If a suggestion matches multiple conditions in the specifications, boost values from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
Note: Currently only support language condition boost.
ConditionBoostSpec
Boost applies to suggestions which match a condition.
JSON representation
{"condition": string,"boost": number}
Fields
condition
string
An expression which specifies a boost condition. The syntax is the same as filter expression syntax. Currently, the only supported condition is a list of BCP-47 lang codes.
Example:
To boost suggestions in languages en or fr: (lang_code: ANY("en", "fr"))
boost
number
Strength of the boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0.
Setting to 1.0 gives the suggestions a big promotion. However, it does not necessarily mean that the top result will be a boosted suggestion.
Setting to -1.0 gives the suggestions a big demotion. However, other suggestions that are relevant might still be shown.
Setting to 0.0 means no boost applied. The boosting condition is ignored.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-30 UTC."],[[["The Boost specification allows for boosting or demoting specific documents based on defined conditions, enhancing control over search result ranking."],["`ConditionBoostSpec` defines the criteria for boosting, allowing the use of a filter-like `condition` to target specific documents and a `boost` value from -1 to 1 to adjust their rank, or a complex `boostControlSpec`."],["`BoostControlSpec` provides fine-grained control over ranking by defining the relationship between a document's attribute value, the `attributeType`, `interpolationType` and `controlPoints` and its boost amount."],["`AttributeType` defines the type of attribute used for custom ranking, allowing for either numerical values or the calculation of freshness based on a date field."],["`ControlPoint` defines the attribute value, which can be a numerical value or a duration spec for freshness, and its associated boost amount, in the context of `BoostControlSpec` custom ranking."]]],[]]
