Smart Product Recommendations Engine

Replace fragile, hand-curated product relations on Adobe Commerce and Magento Open Source with a small set of rules over any product attribute (name, color, manufacturer, custom tags, price) and let the storefront populate Related Products, Up-Sells, and Cross-Sells on its own. For example, a fashion store can configure a single "same-color" rule, and every product page then automatically shows color-matched Related Products – with no need to edit product relations one item at a time.

Smart Recommendations is a deterministic, rule-based engine. It plugs into the platform's three native product-link blocks via plugins, never replaces them, and respects existing admin-curated relations under its Append and Fill-up modes. There is no AI, no external API, no SaaS dependency – the engine runs on your server and reads only your live EAV catalog.

How it works

Each of the three positions (Related, Up-Sell, Cross-Sell) is configured independently:

• Choose one of four interaction modes – Replace native, Append after native, Fill-up to max, or Auto only.
• Define matching rules with priority ordering. Each rule pairs a product attribute with one of seven match types: Token overlap, Slash-tag overlap, Same value, Any value matches, Price range ±%, Starts with, or Exact match.
• Cap output with "Max products" – native and engine output combined always honour the cap. Deduplication across rules is automatic.

The Cross-Sells position aggregates from every line item in the cart and excludes items already added.

A master switch turns the entire module on or off site-wide without clearing rule configuration. Out-of-stock filtering and "hide block when empty" are global toggles that apply to all three positions.

The admin rules editor is a collapsible accordion. Each rule has auto-built title summaries, inline JSON validation for matcher parameters, and compatibility hints when the chosen attribute does not match the matcher's expected EAV input type.

Hyvä Theme is supported out of the box – the module ships an additional plugin on Hyvä's ProductList ViewModel so engine output flows into the same three positions on Hyvä storefronts. No additional setup; install on a Luma + Hyvä multi-store project and both storefronts pick up the engine.

Multi-store ready: every configuration field is store-scoped, so different store views can run different rule sets.

The module owns no database tables. Configuration lives in core_config_data. Disabling the module leaves no orphaned data.

Key features

• Drives the platform's three native product-link blocks – Related Products, Up-Sells, and Cross-Sells – from rules instead of per-product manual curation.
• Four interaction modes per position: Replace native, Append after native, Fill-up to max, Auto only.
• Seven match types over any product attribute: Token overlap, Slash-tag overlap, Same value, Any value matches, Price range ±%, Starts with, Exact match.
• Works with built-in and custom EAV attributes – the attribute picker reads the live catalog.
• Deduplication and budget enforcement across rules: never repeats a product, never exceeds the position's "Max products" cap.
• Out-of-stock filter and "hide block when empty" as global toggles.
• Master Enabled toggle for site-wide on/off without losing rule config.
• Admin rules editor with collapsible accordion, auto-built rule titles, inline JSON validation, and matcher compatibility hints.
• Hyvä Theme storefront support out of the box.
• Multi-store: every field is store-scoped.
• Cache-aware: saves invalidate full_page and block_html automatically.
• No own database tables – configuration in core_config_data.