Skip to main content

Boost Scores

Boosts promote or demote products that match a condition. Profile boosts and the boosts of matching search rules produce one boost score per product. The boosts criterion in the Ranking Order ranks products by that score.

Profile Boosts​

Boosts on a search profile apply to every search that uses the profile:

{
"boosts": [
{ "condition": "extensions.products(Details).is_featured:=true", "weight": 100 },
{ "condition": "extensions.products(Details).on_sale:=true", "weight": 50 },
{ "condition": "extensions.products(Details).stock_status:=out_of_stock", "weight": -100 }
]
}
  • Positive weights push matching products up.
  • Negative weights push matching products down. This is a bury.

To boost or bury only when a shopper query or browse listing matches a trigger, use search rules.

How the Boost Score Is Calculated​

Each product gets the highest weight among all the boost conditions it matches, or 0 if it matches none. Weights do not add up.

With the boosts above, five example products score as follows:

ProductConditions it matches (weight)Boost score
Featured, on saleis_featured (100), on_sale (50)100
On saleon_sale (50)50
On sale, out of stockon_sale (50), stock_status (-100)50
In stock, not featured, not on saleNone0
Out of stockstock_status (-100)-100

A product matching a boost and a bury is boosted, because the higher weight wins. To bury out-of-stock sale items, exclude them from the boost condition: on_sale:=true && stock_status:!=out_of_stock.

Profile and Search Rule Boosts​

When several search rules match, their boosts are merged with each other first. Profile boosts are then combined with that result. For one condition, the higher weight is kept, whether it came from the profile or from a rule.

A storewide profile boosts Nike on every search, and a drill campaign buries Nike when the shopper searches for drill:

SourceConditionWeight
Profile boostsbrand:=Nike100
Matching search rulebrand:=Nike-50

Both name brand:=Nike. 100 is higher than -50, so Nike products stay at 100 on that drill search. The rule bury does not demote them.

The same comparison runs the other way. A profile that buries out-of-season Nike, and a campaign rule that boosts Nike for this query:

SourceConditionWeight
Profile boostsbrand:=Nike-100
Matching search rulebrand:=Nike50

50 is higher than -100, so Nike products receive 50 for this search. The profile bury does not apply to them on this query.

When more than one rule names that condition, those rules are reduced to one weight before the profile is considered. On brand:=Nike:

StepWhat is comparedWeight kept
Earlier ruleBoost 4040
Later ruleBury -80-80. Among rules, the bury replaces the earlier boost
ProfileBoost 100, compared with the merged rule weight -80100. 100 is higher than -80

Nike products are boosted by the profile. The campaign bury never becomes the weight, because the profile clause is higher.

Different conditions from the profile and from rules are both kept. Each product still receives the highest clause it matches. A profile clause is_featured:=true at 100 and a rule clause is_clearance:=true at -100 produce:

ProductFeaturedClearanceWeight
Featured clearance drillyesyes100
Clearance drillnoyes-100
Featured drillyesno100

Where the Boost Score Ranks​

The boost score takes one of the three sort positions. In the default Ranking Order it ranks after the request sort and before text relevance:

  • A boost only reorders products that the criteria above it leave tied. Under the default order, a shopper's price sort ranks first, and boosts order products with the same price.
  • When no profile boost or search rule boost applies, the boost criterion is skipped and takes no position.
  • When the criteria above it fill all three positions, the boost score is not used. Under the default order, that happens when the request sends three sort_by fields.

Test campaigns with the storefront sorts shoppers use. To rank boosts above the request sort, or below text relevance, change the profile's Ranking Order.

Ask External AI