Boost With Signals

The Boost With Signals query pipeline stage performs automatic boosts based on the contents of the aggregated signals collection. For this type of boosting, signals must be enabled but recommendations need not be.

Using the main query and the stage configuration parameters, this stage performs a secondary query to the _signals_aggr collection and returns updated boost weights for the items in the main query’s search results. Items that have received more user interaction also receive higher boost weights.

Some of the important configuration parameters are discussed below. For complete details about all configuration parameters for this stage, see Boost with Signals.

Configuration overview

The fields below are especially useful to understand when configuring this stage.

Number of Recommendations


Sets the rows query param in the main query as the maximum number of query results which will be boosted by this pipeline stage.

Number of Signals


Sets the rows query param in the query that searches the _signals_aggr collection, so only the specified number of aggregated signals are retrieved and used for boosting. When signals boosting is applied to a query, aggregated signals records are queried from the appropriate _signals_aggr collection to find out the popularity or boost weight for documents which have signals. numSignals limits the number of records to be queried from a }}{{_signals_aggr collection and used to calculate this boost.

Aggregation Type


A filter to retrieve aggregated signals in the _signals_aggr collection per each aggregated signal’s aggr_type_s field value.

Solr Field to Boost On


The document field in the main collection on which to perform boosting. Typically it should use default field, which is id.

This field corresponds to the Rollup Field/rollupField field. Together, these two fields act like a <field>:<value> pair in the query modification for boosting.

Boost Method


This adds a query parameter to the original query, either “query-param” or “query-parser”. The result is (“query-param” or “query-parser”) + Boost Param(“boost” or `bq)`, as in the examples below:

“query-param”+"boost", result boost query param
boost="map(query({!field f='id' v=‘6239046,13026192}), 0, 0, 1, 27.1705)"
“query-parser”+"boost", result boost query param
bp_xxx_bbqx="map(query({!field f='id' v=‘6239046,13026192}), 0, 0, 1, 27.1705)"
When Boost Param uses bq, similar logic applies. When Boost Param/boostingParam uses “boost”, it works with both “query-param” and “query-parser”.

Rollup Field


Indicates which aggregated signal document field the boost parameter will use for the final boosting. It works in combination with the Solr Field to Boost On/boostId field.

This should be set to the field in the aggregated signal collection that stores the doc list that is aggregated as one record. By default it’s set to doc_id_s, because by default this is used in the click_signal_aggr SQL job.

Rollup Weight Field


Indicates the final boost weight used to calculate the new score for docs retrieved by the main query.

Similar to Rollup Field/rollupField above, this should be set to the field in the aggregated signal collection that stores the final weight that was calculated. By default it’s weight_d, because by default this is used in the click_signal_aggr SQL job.

Final Boost Weight Expression


Calculates the final weight using the weight and score retrieved from the _signals_aggr collection.

The default value is math:log(weight_d + 1) + 10 * math:log(score+1).

Solr query parameters

These parameters are used in the Solr Query parameters/queryParams field for retrieving signal aggregation docs from the _signals_aggr collection. These Solr query params will affect which aggregated signals are used for producing the boosting parameter on the main query.


Defines which field to query. In the default case, the query searches on the query_t field of aggregated signal docs.


Boosts docs within the set of retrieved docs using phrase matching.


pf2 is similar to pf; the difference is that pf2 works on bigram phrases.


pf3 is similar to pf; the difference is that pf3 works on trigram phrases.


If there is fq in the main query, how is it matched with the correct aggregated signal?

In this case, you need to use the lw.rec.fq query parameter in the main query. lw.rec.fq can be parsed by the Boost with Signals stage, and therefore the filters specified in it can be added to the Solr query that is retrieving the aggregated signals.

For example, if we have filter query param fq=format:CD&fq=name:Latin, this needs to be translated into lw.rec.fq=filters_s:"format:CD $ name:Latin". The final main query should be:

http://localhost:8764/api/apollo/apps/demo_app/query-pipelines/demo_app/collections/demo_app/select?echoParams=all&wt=json&"format:CD $ name:Latin"

Now the Boost with Signals stage will only retrieve aggregated signals that have the same filter query.

What if my aggregated signals are in a different collection?

You can point the Boost with Signals stage to a different signal collection by adding a collection parameter in the Solr Query Parameters section.

BwS collection