Algolia Recommend for Magento

Algolia Recommend lets you display recommendations from your product catalog on your website. Users can jump to similar or complementary items if an item isn’t what they are looking for.

Before you begin

Before you can use Algolia Recommend with Magento, check these requirements:

Algolia extension for Magento Open Source and Adobe Commerce version 3.8 or later
You’re sending click and conversion events. Algolia Recommend relies on click and conversion events to continuously improve its recommendations. You can also upload events via CSV to get started.

Guide Set up Algolia Recommend

Blog Algolia Recommend for Adobe Commerce

In your Magento dashboard, go to Stores > Configuration > Algolia Search > Recommend Products Settings. You can enable these recommendation models:

Frequently Bought Together

Configure the Frequently Bought Together recommendations in the Magento dashboard

Set Enable on PDP to Yes to show recommendations from this model on product detail pages below the main product information. If you’re using recommendations from Algolia’s Frequently Bought Together model, you should remove the default upsell products from the user interface.

Set Enable on Cart Page to Yes to show Frequently Bought Together recommendations on the shopping cart page below the More choices section.

Remove the Magento upsell products block

To hide Magento’s default upsell products, set Remove The Magento Upsell Products Block to Yes.

Configure the Related Products recommendations in the Magento dashboard

Set Enable on PDP to Yes to show recommendations from this model on product detail pages. The recommendations appear below the main product information after the Frequently Bought Together recommendations (if active). If you’re using recommendations from Algolia’s Related Products model, you should remove the default related products from the user interface.

Set Enable on Cart Page to Yes to show Related Products recommendations on the shopping cart page.

You can configure content-based filtering in the Algolia dashboard.

To hide Magento’s default related products, set Remove The Magento Related Products Block to Yes.

Configure the Trending Items recommendations in the Magento dashboard

Display a list of trending items using the Trending Items model from Algolia Recommend on product detail, shopping cart, and other pages.

Set Enable on PDP to Yes to show the recommendations from the Trending Items model on product detail pages. The recommendations appear below the main product information after the Frequently Bought Together and Related Products recommendations (if active).

Set Enable On Cart Page to Yes to show the Trending Items recommendations on the shopping cart page.

Set Enable Trending Items Widgets to Yes to show the Trending Items recommendations on the CMS pages where the Trending Items widget is present.

Add a Trending Items widget with the Algolia Recommend Trending Items widget.

To configure this widget, add these details:

Number of Trending Items. Select the number of recommendations you want to show in the widget.
Facet name. Select a facet for filtering the recommendations, for example, color.
Facet value. Select a value corresponding to the Facet name. For example, if you selected color as the facet name, selecting blue will only show blue products in your recommendations.

Override the file view/frontend/web/internals/template/recommend/products.js from the original extension following Magento best practices.

Adding fallback recommendation

Fallback recommendations are shown when the Algolia Recommend model doesn’t return any recommendations. This can happen when a product doesn’t have enough events associated with it. You can implement fallback recommendations with fallbackParameters and fallbackComponent. To add fallback recommendations, override the file view/frontend/web/recommend.js from the original extension following Magento best practices.

fallbackParameters is a key-value mapping of search parameters to utilize as an alternative when no recommendations are available. Add fallbackParameters to the following files as needed:

For example:

Copy
recommendJs.relatedProducts({
    container: '#relatedProducts',
    recommendClient,
    indexName,
    objectIDs: currentObjectID,
    maxRecommendations: this.config.recommend.limitRelatedProducts,
    fallbackParameters: {
        numericFilters:["ordered_qty > 2"]
    },
    itemComponent({item, createElement, Fragment}) {
        if (config.recommend.isAddToCartEnabledInRelatedProduct) {
            return renderRecommendDataWithAddToCart(item, createElement);;
        }else{
            return renderRecommendData(item, createElement)
        }
    },
});

fallbackComponent is used for rendering when no recommendations are returned. Add fallbackComponent to the following files as needed:

Frequently Bought Together

For example :

Copy
recommendJs.frequentlyBoughtTogether({
    container: '#frequentlyBoughtTogether',
    recommendClient,
    indexName,
    objectIDs: config.algoliObjectId,
    maxRecommendations: algoliaConfig.recommend.limitFBTProducts,
    transformItems:function (items) {
        return items.map((item, index) => ({
            ...item,
            position: index + 1,
        }));
    },
    headerComponent({html}) {
        return recommendProductsHtml.getHeaderHtml(html,algoliaConfig.recommend.FBTTitle);
    },
    itemComponent({item, html}) {
        return recommendProductsHtml.getItemHtml(item, html, algoliaConfig.recommend.isAddToCartEnabledInFBT);
    },
    fallbackComponent() {
        recommendJs.relatedProducts({
            container: '#frequentlyBoughtTogether',
            recommendClient,
            indexName,
            objectIDs: config.algoliObjectId,
            maxRecommendations: algoliaConfig.recommend.limitRelatedProducts,
            transformItems:function (items) {
                return items.map((item, index) => ({
                    ...item,
                    position: index + 1,
                }));
            },
            headerComponent({html}) {
                return recommendProductsHtml.getHeaderHtml(html,algoliaConfig.recommend.relatedProductsTitle);
            },
            itemComponent({item, html}) {
                return recommendProductsHtml.getItemHtml(item, html, algoliaConfig.recommend.isAddToCartEnabledInRelatedProduct);
            },
        });
    }
});