Skip to content



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


First of all you need to install the Yoochoose Recommendation Engine Extension. It can be done through 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 a standard web shop. If you are configuring a highly visited web shop (over a million page requests per month), it makes sense to ask for 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 http (port 80) and https (port 443) ports must be open for outbound TCP connections. You cannot build the firewall rule based on IP. The Yoochoose infrastructure is located in the AWS cloud and the IP addresses can change.

Available Recommendation Blocks

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

  • Bestseller are shown on the home page for all visitors and on the main category pages. 
  • Personal 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 products are products that customers usually buy together with the current product (for example, butter together with bread).
  • Up-Selling recommendations (on the product details block) show products that customers buy instead of the current product (for example printer "Canon" instead of "HP").
  • Cross selling products are similar to the related products, but they are calculated based on the customer's shopping cart.

Personalized Search integration

We also offer a Personalized Search Service which can search for Vendors, Category and Products. It can be activated in the Magento2 back end 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.

Read the Docs