Getting started
A few steps from a finished setup to your first recommendations on the product page and in the cart.
This guide takes you quickly from a finished setup to visible recommendations in the shop. You create a template, add it to the product page and, if you like, switch on recommendations in the side cart. The time estimate applies once your products have been read in.
Requirements
The plugin is installed and activated. See Installation.
The setup wizard is finished and your products are indexed. See Setup wizard: product feed.
Step 1: Check the status
Open Content → InsightSearch. The overview shows the card "System status".
"Connection" should show "Connected".
"Data sources" should count at least one data source.
If the notice "Data sources exist, but none are assigned to a language/sales channel yet." appears, click "Assign languages". Assign your sales channels and languages to the data source there and save. Without this assignment, the shop does not deliver any recommendations.
Step 2: Create a template
A template defines which products are recommended. For the product page, similar or matching products work well.
In the sidebar, open Delivery → Recommendation templates and click "Create template".
In the "Quick start" card, choose "Automatic (recommended)" in the "Preset" field. It sets proven starting values for similar products and prefers products in stock.
Under "General", enter a "Name", for example "Product page similar". The name is only visible in the Administration.
Click "Save".
Step 3: Add it to the product page
Templates only appear in the shop once they are embedded. On the product page this is done through a Shopping Experience.
Open Content → Shopping Experiences and the layout of your product page (type product page).
Add a block from the category "AI CrossSelling", for example "AI CrossSelling: Standard-Karten". The block names are in German, also in the English Administration.
In the element, select your new template under "Recommendation template". Enter a title, for example "Goes well with".
Save the layout and assign it to the products (standard Shopware, for example as the default layout for product pages).
The product source is set to "Automatic (PDP)": the recommendations then always refer to the product the customer is currently viewing.
Step 4: Recommendations in the side cart
The side cart (offcanvas) opens as soon as a customer adds something to the cart. You do not need a Shopping Experience for this.
Create another template as in step 2, this time with the preset "Cart: matching accessories". It mixes recommendations for all cart items and excludes products already in the cart.
Open Delivery → Placements and the section "Offcanvas".
Leave "All sales channels" at the top or choose a sales channel.
Switch on "Enable" and select the new template under "Recommendation template".
Click "Save".
For the cart page, do the same in the section "Cart". Changes to offcanvas and cart take effect immediately.
Step 5: Test
Preview in the template: open the saved template again. The "Preview" card calculates exactly with the template's settings. Choose a "Reference product" and click "Refresh preview". The preview only appears after the first save.
Recommendation sandbox: under Products & data → Products you can try templates on any product and compare two settings. The sandbox saves nothing and does not affect the shop.
In the shop: open a product page and add a product to the cart.
See Preview and sandbox for more.
Tip: avoid empty blocks
If a template finds no products, the block disappears from the page. To make sure something always appears, set a fallback in the template in section "5. Display":
"Fallback threshold (≤)"
For example 2. The fallback applies as soon as at most this many products were loaded.
"Fallback type"
"Other template", "Fixed products" or "Dynamic product stream".
"Fallback template"
For example a bestseller template (bestsellers from plan Starter).
Read more
Creating recommendation templatesShopping experience elementsCart and offcanvas cartHow-to guidesLast updated
