Recommendations

Recommendations puts together an outfit for every main product: articles of other product types that go with it. A jacket gets a shirt, trousers, a belt, shoes and a pocket square, never the same jacket in another colour. Applied proposals are a normal cross-selling list in the shop. The shop shows it on its own and does not need plinth for that.

The work always runs in the same order: compute proposals, check, adjust where needed, look at the preview, apply.

Where do I find it?

Open Products > Recommendations. The search (Ctrl K) finds the page with "recommendations", "outfit" or "cross-selling".

The tiles are quick filters. One click shows the entries, a second click removes the filter.

Requirements

• The permission View recommendations to open the page and compute proposals.
• The permission Write recommendations to the shop to pin, exclude, apply and undo.
• The permission Change settings and outfit rules of the recommendations for settings and rules.
• Your Shopware access needs the rights product_cross_selling and product_cross_selling_assigned_products (create, update, delete). Without them Shopware refuses the write with 403 and the page says so.
• The quality check must have filled the product cache of the shop. The proposals are computed from it.

How is a proposal made?

Per role of the outfit the article with the most points is chosen, then a second round follows until the list is full. So the list reads like an outfit and not like a category.

Signals in this order:

1. Confirmed looks from Shop the Look: articles that were worn together.
2. Articles bought together. Only counts per article are used, no customer data.
3. The outfit map of the rules: which product type goes with which.

Points are added for colour harmony, occasion, season, price level and sizes in stock.

These rules are never broken:

• Same department: men's and women's are never mixed.
• The article is active, in stock and has a picture.
• Never the same model in another colour and no article of the product's own type.
• No clashing colours, and not formal with sporty.
• The price level is inside the set range. The price is compared with the usual price of the product type: an upmarket jacket gets upmarket belts.
• At most the set number of articles per brand.

How do I check a proposal?

1. Click Compute proposals. Nothing is written to the shop.
2. Every row shows the product and the proposed articles with a picture. Hover over a picture to see why the article was chosen.
3. Open a row with the arrow. Why these articles lists the role in the outfit, the points and every single reason per article.

How do I adjust a list by hand?

Open the row of the product.

• Pin: the article always stays in the list of this product, at the front.
• Exclude: the article is never proposed for this product again.
• Under Decide on an article yourself enter a product number and pin or exclude the article.
• The cross on a decision removes it.

The proposal is computed again at once. The shop is only written when you apply.

How do I apply proposals to the shop?

1. Select products and click Preview for the selection, or Preview: apply ... lists at the top for everything the filter shows.
2. The preview reads the shop and shows per product what the shop has and what it will have.
3. Click Apply ... lists. The run appears among the background jobs.

If your role needs an approval for cross-selling changes, the change is submitted for approval and written only after that.

What happens in the shop?

plinth writes exactly one list of its own per product at position 50 and changes or deletes only that one. The automatic list of the shop theme at position 100 and lists kept by hand stay untouched. As soon as a product has a list from plinth, the theme no longer creates its own for this product at night.

If another list already sits at position 50, plinth writes nothing for this product and shows Another list at position 50.

How do I undo a run?

Right after applying, the message offers Undo. Later you find the run among the background jobs. Lists the run created are deleted, lists it changed get their earlier articles back. After that the theme creates its automatic list again in the following night.

How do I change settings and rules?

At the bottom of the page, with the permission for settings:

• Settings: name of the list in the shop, articles per list, minimum stock, price range, articles per brand, weights and the nightly run. The second list Similar articles (position 60) is off by default.
• Outfit rules and colour harmony: which product type goes with which, which colours go together and which clash. The rules are data and apply per shop.

Changes apply from the next computation.

Which background jobs does the area start?

• Compute recommendations: on demand and every night. Writes nothing to the shop.
• Write recommendation lists to the shop: only when a person starts it.

Common errors and solutions

See also

• Shop the Look
• Products
• Background jobs