AI Upsell & Cross-sell
Overview
Upsell means a higher-value alternative from your catalog. Cross-sell means a complementary product (accessory). Both are selected from WooCommerce, not generated as fake SKUs.
AI is optional: it may suggest accessory search queries. Without a key, WooCommerce Upsells, Cross-sells, Related products, and catalog search still feed the recommender.
How It Works
- Context: current product page, cart contents, or chat request (
Recommendation_Context_Builder). Related_Product_Sourcereads WooCommerce linked products first.- Recommender searches/scores additional live products.
- Classifier filters (in-stock, not already in cart, etc.).
- Slice to Maximum recommendations (1–4, default 3).
- Widget displays cards. Add-to-cart uses the same confirmation rules as search cards.
REST: GET /aiwsa/v1/recommendations?context=product|cart when the widget opens (not on raw page load).
How to Enable It
WooCommerce → AI Assistant → Recommendations → Enable AI upsell & cross-sell plus the placement toggles. Keep Enable recommendations tool on.
Configuration
Frontend Usage
- Open chat on a product page → optional suggestion block.
- Open mini-cart → complementary cards if cart recommendations are on.
- Ask “what else should I get?” if chat recommendations are on.
Example customer journey
- Shopper views a DSLR product page and opens the assistant.
- Plugin loads WooCommerce Cross-sells (memory card, bag).
- Shopper adds the camera from chat (confirms).
- Mini-cart shows the bag as a complementary suggestion.
- Shopper adds the bag, then Checkout to WooCommerce checkout.
Behavior
| Situation | What happens |
|---|---|
| Linked products filled | Those IDs preferred |
| No linked products | Catalog search / related |
| No AI key | Same, without query expansion |
| Feature off | No suggestion blocks |
REST 404 on /recommendations | Widget swallows error; chat still works |
| Out of stock candidates | Dropped by validator |
Add-to-cart behavior
Same as Cart: AI-staged adds need Confirm. Prices cannot be set by the client.
Limitations
- Not a machine-learning personalization cloud.
- Semantic “customers who bought” engine is WooCommerce related/linked + search, not a third-party CDP.
- Maximum 4 cards per block.
Troubleshooting
Empty suggestions: add Linked Products on the product, ensure items are purchasable, enable the tool, check REST permalinks if the network tab shows 404.