Recommendations settings (AI Upsell & Cross-sell)
Navigation: WordPress Admin → WooCommerce → AI Assistant → Recommendations
Card title in admin: AI Upsell & Cross-sell.
Suggestions come from WooCommerce upsells, cross-sells, related products, and live catalog search. AI is optional and only helps generate accessory-style search queries. Prices and stock are never invented.
If a licence filter sets recommendations to false, the page shows that the feature is unavailable.
Enable AI upsell & cross-sell
What it does Master switch. When off, the assistant will not suggest upgrades or accessories. Product search is unchanged.
Default value On.
Available options On / Off.
Recommended configuration On.
When to use it Off if you only want search, not suggestions.
Effect on the frontend Off: no product-page block, no mini-cart suggestions, no “what else?” chat cards from this feature.
Dependencies Tool Enable recommendations (recommend_products).
Important notes Works without an API key using WooCommerce relationships and search.
Example On for a store that fills WooCommerce Linked Products.
Maximum recommendations
What it does Cards shown in each recommendation block.
Default value 3
Available options 1–4
Recommended configuration 3
When to use it 2 on very small screens; 4 if you have rich related-product data.
Effect on the frontend Fewer or more suggestion cards.
Dependencies None.
Important notes Hard cap is 4 in admin.
Example 3 cards under the mini-cart.
Enable product-page recommendations
What it does Load suggestions when the shopper opens the assistant on a product page. Not on every page load.
Default value On.
Available options On / Off.
Recommended configuration On.
When to use it Off if product pages already have a heavy related-products section and you want chat-only suggestions.
Effect on the frontend Opening chat on a product permalink fetches GET /aiwsa/v1/recommendations?context=product. If permalinks or REST registration fail, the widget swallows the error and chat still works.
Dependencies rec_enabled, recommend_products tool.
Important notes Lazy: only when the widget opens.
Example Shopper opens chat on a blender product page and sees compatible jars.
Enable cart recommendations
What it does Suggest complementary products from the current cart inside the chatbot mini-cart. WooCommerce linked products are used first; otherwise live catalog matches.
Default value On.
Available options On / Off.
Recommended configuration On if you maintain cross-sells in WooCommerce.
When to use it Off if cart already has many upsell plugins.
Effect on the frontend Mini-cart may show extra cards. Widget calls GET /aiwsa/v1/recommendations?context=cart.
Dependencies Same as above.
Important notes Uses the WooCommerce session cart, not a parallel cart.
Example Camera in cart → memory card suggestion from Cross-sells.
Enable chat recommendations
What it does Answer “what else should I get?” and “is there a better version?” from the catalog.
Default value On.
Available options On / Off.
Recommended configuration On.
When to use it Off to keep the model from calling recommend_products.
Effect on the frontend Recommendation cards in the transcript when the shopper asks.
Dependencies AI optional; without a key, native catalog turns can still surface recommendations from the catalog.
Important notes Needs the recommendation tool enabled.
Example “Is there a better version of this starter motor?”
Use AI for recommendation intent
What it does One cached AI call may suggest accessory search queries. Without an API key, WooCommerce upsells, cross-sells, and related products are used.
Default value On.
Available options On / Off. Licence-gated (recommendations_ai).
Recommended configuration On if you have a key; Off to save tokens.
When to use it When linked products are sparse and you want query expansion.
Effect on the frontend Possibly more relevant accessories. Failures silently use WooCommerce relationships.
Dependencies API key for the AI path; catalog path always available.
Important notes The model does not pick prices. IDs are re-validated as live WooCommerce products.
Example On for a large catalog with few Linked Products filled in.
Recommendation tools
Enable recommendations (recommend_products)
Ranks matching catalog products for a shopper request.
Default: On.
Enable product comparison (compare_products)
Compares two to four catalog products the shopper is considering.
Default: On.
See Product comparison.