Child pages
  • Magento2 Connect Extension Tutorial
Skip to end of metadata
Go to start of metadata


If you are not familiar with the usage of recommendations, please read at least the two first pages of the User Guide [1].



First of all you need to install the Yoochoose Recommendation Engine Extension. It can be done over the webpage (search for "yoochoose"). The extension is free to download and install. The service itself is based on performance of the recommendations. See our pricing page for details.

In order to install the extension on your local Magento2 installation, your purchases need to be in sync via the Web Wizard Setup -> Component Manager (

Account Registration

Before the recommendation engine can be enabled for your web shop, you must register a new "Magento Connect" account on the Yoochoose web page. 

Select the Magento Module in the option box (Magento2 and Magento use the same registration link)

or use the direct link

An account contains a default scenario configuration for an average web shop. If you are configuring a highly visited web shop (over a million page requests per month), it makes sense to ask for the special consulting and phone support by Yoochoose GmbH.

The registration itself is straightforward and self explaining. After it is finished, you will get a customer ID and the license key for the recommendation extension.

Activation of the YOOCHOOSE Extension in the Magento2 Backend

The Extension configuration/enabling is located in the Magento Admin Panel under:

Stores → Configuration → YOOCHOOSE



In the admin interface of Magento 2 you can now enter the Customer ID and License Key information that you obtained after the successful registration process.

Firewall Configuration

The Magento2 Recommendation module needs connection to the Yoochoose configuration server:

Both port http (port 80) and https (port 443) must be open for outbound TCP connections. One must not build the firewall rule based on IP. The Yoochoose infrastructure is located in the AWS (Amazon Web Services) cloud and the IP addresses can change.

Available Recommendation Blocks

The Yoochoose extension works automatically after the installation and begins to track page visitors. The following blocks are available for recommendations:

BestsellersBestsellers are shown on the home page for all visitors and on the main category pages.
Personal recommendationsPersonal recommendations are shown to registered customers or to anonymous visitors with a persistent or long living session. It analyses the purchasing and click history of the visitors and suggests new products.
Related productsRelated products are products customers usually buy together with the current product (for example butter together with bread).
Up-SellingUp-Selling recommendations (on the product details block) shows products customers buys instead of the current product (for example printer "Canon" instead of "HP").
Cross sellingCross selling products are similar to the related products, but they are calculated based on the customer shopping cart.

Landing and Category page



Detail Page

Shopping Cart

Personalized Search integration

We also offer a Personalized Search Service which can search for Vendors, Category and Products. This can be activated in the Magento2 backend in the Extension configuration.

An example of the search results can be seen here:

Development and Maintenance

Further development of the extension is welcome. We have a bitbucket repository located under Don't hesitate to contact us for improvements, bug fixes or anything else related to the extension.


  1. Yoochoose Recommendation Engine User Guide
  2. Yoochoose Recommendation Engine Developer Guide
  3. Yoochoose Configuration Backend
  • No labels