# Boosting

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 <a href="#boosting-items-based-on-attributes" id="boosting-items-based-on-attributes"></a>

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

A filter boost has two fields, a [filter-expressions](https://docs.search.io/documentation/fundamentals/filter-expressions "mention") 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.

![](https://3882858970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVeIbtsTcQaqaNeKzLbbU%2Fuploads%2Fkke6NDcAPZianAWOmzae%2Fimage.png?alt=media\&token=d7a34095-b453-45dc-9bca-d5b495a90186)

**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 <a href="#boosting-items-within-a-numeric-range" id="boosting-items-within-a-numeric-range"></a>

*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.

![](https://3882858970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVeIbtsTcQaqaNeKzLbbU%2Fuploads%2FBSqecgvQBMLe0ikr8wYp%2Fimage.png?alt=media\&token=9bfa134a-b12d-457a-be7e-5a02044f91b4)

**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   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.search.io/documentation/fundamentals/promotion-rules/boosting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
