Recommend Items for Item Stage

The Recommend Items for Item query pipeline stage uses signals about users' item choices to recommend similar items based on a specific item. For example, this stage can recommend a list of similar books on a Web page that displays information about a specific book.

Similarity can be based on different criteria, such as click patterns, people who bought this also bought that, percentage match of document tags, and so on.

This pipeline stage uses items-for-item recommendations that have been precomputed by an ALS (Alternating Least Squares) Spark recommender.

See Collaborative Filtering for more information.


Enable recommendations:

Before creating a Recommend Items for Item stage, enable recommendations.

  • In the Fusion UI – With the Query Workbench open, click Settings > Enable Recommendations.

  • Using the REST API – Use this command to enable recommendations:

    curl -u admin:<password> -X PUT \http://<hostname>:<port>/api/v1/collections/<collection-name>/features/recommendations -H 'content-type: application/json' -d '{"enabled":true}
When you enable recommendations, Fusion creates a query pipeline that already contains this stage, and that is configured for boosting. The query pipeline is <collection>_items_for_item_recommendations.


When entering configuration values in the UI, use unescaped characters, such as \t for the tab character. When entering configuration values in the API, use escaped characters, such as \\t for the tab character.