When you create a recommendation, you are creating what is called a 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, clicks, and so on. The Product Recommendations dashboard displays these metrics for each recommendation unit to help you make informed business decisions.
On the Admin sidebar, go to Marketing > Promotions > Product Recommendations to display the Product Recommendations dashboard.
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.
Click the Create Recommendation button.
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.
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.
- Home Page
- Product Detail
- Page Builder
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.
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.
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
In the Select placement section, specify the container where you want the recommendation unit to appear on the page.
- At the bottom of main content
- At the top of main content
(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.
(Optional) In the Filters section, you can apply filters that control which products can be displayed in recommendations.
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.
Use the Recommended products preview panel to preview what products will be displayed in a recommendation unit when deployed to your storefront.
The preview panel supports fetching recommendations from a different environment. This allows merchants who are testing in a non-production environment to experiment with rules and preview the recommendations before deploying to production.
|Name||Name of the product|
|SKU||Stock Keeping Unit of the product|
|Price||Price of the product|
|Result Type||Primary indicates that there is enough training data collected to display a recommendation. Backup indicates there is not enough training data collected so a backup recommendation is used to fill the slot. See Training time for machine learning models to learn more about machine learning models and backup recommendations|
As you create your recommendation unit, experiment with the page type, recommendation type, and filters to get immediate real-time feedback about the products that will be included. As you begin to understand what products will be displayed, you can configure the recommendation unit to best meet your business needs.
What appears in the preview panel and on the storefront can occasionally vary. This is because Magento filters recommendations to avoid displaying duplicate products when multiple recommendation units are deployed on a single page.