After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Create New Recommendation

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.
Magento Commerce only. Learn more.

When you create a recommendation, you are creating what is called a recommendation unit:

Recommendation unit

The products inside the recommendation unit are called recommended items.

After you create and activate the recommendation unit, Magento will begin collecting metrics that measure data such as impressions, views, and clicks, and so on. The Product Recommendations dashboard displays these metrics for each recommendation unit to help you make informed business decisions.

  1. On the Admin sidebar, go to Marketing > Promotions > Product Recommendations to display the Product Recommendations dashboard.

  2. Specify the Store View where you want the recommendations to display.

    You can create recommendation units for the Page Builder page type only in the default store view.

  3. Click the Create Recommendation button.

  4. In the Name your Recommendation section, enter an internally-facing name that uniquely identifies the recommendation on your dashboard, such as Home page most popular.

  5. In the Select page type section, select the page on which you want the recommendation to appear.

    You can create up to five active recommendation units for each page type. If a page type option is grayed-out in the Admin UI, the limit has been reached and an explanation is shown. However, the Page Builder page type allows you to create up to 25 recommendation units because you can use Page Builder to edit arbitrary content types.

    Options are:

    • Home Page
    • Category
    • Product Detail
    • Cart
    • Confirmation
    • Page Builder
  6. In the Select Recommendation type section, specify the type of recommendation you want to appear on the selected page type. Note that certain page types restrict what type of recommendation you can select.

  7. In the Storefront display label section, enter an externally-facing name your shoppers will see, such as “Top sellers”.

    Magento provides the following guidance for label names.

    If you selected Page Builder as your page type, you will specify the Text or Heading element as your storefront display label in the Page Builder editor.

  8. In the Choose number of products section, use the slider to specify how many products you want to appear in this recommendation unit.

    The default is 5. Maximum is 20.

  9. In the Select placement section, specify the container where you want the recommendation unit to appear on the page.

    Options are:

    • At the bottom of main content
    • At the top of main content.
  10. (Optional) Select and move the rows in the Choose position table to order the recommendations within the container.

    The Choose position section displays all recommendations (if any) created for the page type you selected.

  11. (Optional) In the Exclude categories section, specify the product categories that should not be included as part of this recommendation. You can select up to 25 categories. You also can specify categories you want to exclude from all recommendations.

  12. When you finish configuring your recommendation you can click:

    • Save as draft to edit the recommendation unit at a later date. Note that you cannot modify the page type or recommendation type for a recommendation unit in a draft state.

    • Activate to enable the recommendation unit on your storefront.