Product Recommendations setup

Product Recommendations displays relevant products to customers based on their browsing history and preferences, helping increase cross-selling. You must enable and configure this feature before adding it to your pages. Once configured, it displays as specific recommendation units that you can place on any page.

Configuration

Add this table to your document to configure the block:

product-recommendations
currentSku	crz-eco-tr-std-2017 (example)
recId	2ed7ea09-d9bd-4691-91c3-2c0a6d4fd869 (example)

• recId: Recommendation ID for targeting specific recommendation types. Required for all pages. No default value.

• currentSku: Current product SKU for recommendation context. Required for non-PDP pages only. Not needed for product detail pages. No default value.

Important

• PDP pages require only the recId to be set.
• Other pages require both the recId and currentSku to be set.

How to enable and configure Product Recommendations

The Product Recommendations block can be configured on each page through Document Authoring. Follow the step-by-step guide below to enable and configure Product Recommendations:

Create a recommendation unit

You must first create recommendation units in the Adobe Commerce Admin (PaaS) or Adobe Commerce Optimizer Admin (SaaS).

Adobe Commerce Optimizer Admin (SaaS)

The following steps apply to merchants using Adobe Commerce Optimizer or Adobe Commerce as a Cloud Service.

1. Log in to the Adobe Commerce Optimizer Admin.

2. On the Admin sidebar, go to Recommendations.

3. Follow the steps in the user guide to create a recommendation unit.

Note

For Adobe Commerce Admin (PaaS), follow the steps in the user guide to create a recommendation unit.

Get the recommendations unit ID

You can specify which recommendation unit to display on each page by using the recommendation unit ID.

1. Navigate to the Product Recommendations page in the Adobe Commerce Admin or Adobe Commerce Optimizer Admin.

2. Click the eye icon next to the recommendation unit that you’d like to display on your store.

3. Copy the Recommendation ID from the modal.

You will use this ID in the next step to configure the recommendations block.

Add and configure the recommendations block

You can configure each page to display a specific recommendation unit by setting its recommendation ID.

1. Open the page where you want to display the recommendation unit.

2. Create a new table in your document with the block name product-recommendations.

   For product detail pages, set the recId to match the recommendation unit ID from the previous step. For example:

   product-recommendations
   recId	2ed7ea09-d9bd-4691-91c3-2c0a6d4fd869

   Note

   PDP pages require only the recId to be set as shown above.

   Other pages require both the recId and currentSku to be set. For example:

   product-recommendations
   currentSku	crz-eco-tr-std-2017
   recId	2ed7ea09-d9bd-4691-91c3-2c0a6d4fd869

Section metadata

Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional:

section-metadata
Style	light (optional)
Padding	medium (optional)
Margin	small (optional)
Column Width	30% (optional)
Gap	small (optional)

Learn more

See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options.