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."],[[["\u003cp\u003eThe Boost specification allows for boosting or demoting specific documents based on defined conditions, enhancing control over search result ranking.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eConditionBoostSpec\u003c/code\u003e defines the criteria for boosting, allowing the use of a filter-like \u003ccode\u003econdition\u003c/code\u003e to target specific documents and a \u003ccode\u003eboost\u003c/code\u003e value from -1 to 1 to adjust their rank, or a complex \u003ccode\u003eboostControlSpec\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eBoostControlSpec\u003c/code\u003e provides fine-grained control over ranking by defining the relationship between a document's attribute value, the \u003ccode\u003eattributeType\u003c/code\u003e, \u003ccode\u003einterpolationType\u003c/code\u003e and \u003ccode\u003econtrolPoints\u003c/code\u003e and its boost amount.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAttributeType\u003c/code\u003e defines the type of attribute used for custom ranking, allowing for either numerical values or the calculation of freshness based on a date field.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eControlPoint\u003c/code\u003e 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 \u003ccode\u003eBoostControlSpec\u003c/code\u003e custom ranking.\u003c/p\u003e\n"]]],[],null,[]]
