Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Prefer a guided path? The setup assistant creates several templates at once. This page shows the manual way so you get to know the most important places.

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.

  1. In the sidebar, open Delivery → Recommendation templates and click "Create template".

  2. 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.

  3. Under "General", enter a "Name", for example "Product page similar". The name is only visible in the Administration.

  4. Click "Save".

Which preset suits the product page?
Preset
Purpose
From plan

"Automatic (recommended)"

Similar products as alternatives. Works from day one, even without orders.

Basic

"Accessories (product page)"

Products often bought together of matching product types; without purchase data, similar matching products.

Basic

"Frequently bought together (purchase data only)"

Only real joint purchases. Needs order history.

Expert

The "matching types" setting in the preset "Accessories (product page)" only works with product type detection. This is a beta feature that InsightSearch unlocks for you. Without it, the preset behaves as if no product type were set.

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.

  1. Open Content → Shopping Experiences and the layout of your product page (type product page).

  2. 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.

  3. In the element, select your new template under "Recommendation template". Enter a title, for example "Goes well with".

  4. 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

Available from plan Starter.

The side cart (offcanvas) opens as soon as a customer adds something to the cart. You do not need a Shopping Experience for this.

  1. 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.

  2. Open Delivery → Placements and the section "Offcanvas".

  3. Leave "All sales channels" at the top or choose a sales channel.

  4. Switch on "Enable" and select the new template under "Recommendation template".

  5. 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":

Setting
Recommendation

"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 guides

Last updated