Product Documentation
Product DocumentationDeveloper GuideAPI ReferenceHelp Center
  • About Search.io
  • Fundamentals
    • Search settings
      • Understanding relevance and ranking
      • Textual relevance
      • Ranking adjustments
      • Dynamic boosting
      • Synonyms
      • Redirects
    • Promotion rules
      • Triggers
      • Manual curation
      • Boosting
      • Banners
    • Integrating search
      • Display options
      • Filters and sort options
      • Result templates
      • Search UI integration
    • Roles & permissions
    • Reporting
      • Event tracking
      • Trends
      • Content issues
      • Explore
    • Filter expressions
    • Indexing Data
      • Schema
  • Guides
    • General
      • Previewing results
    • 📄Content websites
      • Crawling a website
      • Adding custom fields
      • Configuring domains
      • Excluding documents
      • Improving content
    • 🛍️E-commerce
      • Define schema and sync data
      • Relevance tuning
      • Creating a user interface
      • Adding a sale banner
  • Integrations
    • Shopify
      • Shopify metafields
    • Webflow
    • Drupal
    • Wordpress
  • Deep dives
    • Concepts and terminology
    • How Search.io works
    • Autocomplete
    • Spelling
  • Helpful Links
    • Developer Documentation
    • API Reference
    • Help Center
Powered by GitBook
On this page
  • Boosting items based on attributes
  • Boosting items within a numeric range

Was this helpful?

  1. Fundamentals
  2. Promotion rules

Boosting

PreviousManual curationNextBanners

Last updated 3 years ago

Was this helpful?

In addition to precisely pinning items to a specific position, you can also change the order in which non-pinned items appear. In particular, for large results sets, automated boosting is a great way to fine-tune your Search or Category pages and increase click-through rates, conversions, margins, or other business metrics.

Boosting items based on attributes

Filter boosts are a great way to promote and personalize results.

A filter boost has two fields, a Filter expressions and a boost score. The boost score has a value between 0 and 1, with 1 being the maximum available boost.

Results that match the filter expression receive a boost according to the given score.

Example

Assuming you want to promote Nike shoes on your "shoes" category page. The following Filter boost will boost Nike shoes by a score of 0.8.

Filter
Score

brand = "nike"

0.8

But filter boosts aren't limited to pre-defined values like "nike" in the example above. Instead, the filter expression can reference dynamic parameters passed into the search.

To personalize results, you can pass information about the user, such as brand affinity, into the search query and improve the search results based on that data.

{
    "variables": {
        "q": "headphones",
        "brandAffinity": "Adidas"
    }
}

In the above query example, we pass a variable called "brandAffinity" to the search query. We can reference the variable in the filter boost like so:

Filter
Score

brand = brandAffinity

0.7

Boosting items within a numeric range

Range Boosts can promote results that fall within a specific numeric range. Boosting is applied linearly between the start and the endpoint. For example, use Range Boosts to boost highly rated products, popular products, or inventory to be sold.

Example

Assume that you have a rating field that ranges between 0-5. You want to boost values between 2-4 linearly, where 2 receives the smallest boost and 4 (and above) the maximum boost. Thus, ratings between 0 and 2 will receive no boost.

The configuration for this would look as follows: the score boost of 0.4 is the maximum boost applied to values of 4 and above.

Field
Start
End
Score

rating

2

4

0.4