Browse documentation

How It Works

Product eligibility and availability

Smart Related Products protects relevance by returning candidates that are suitable to show now, not simply products that appeared together in past orders.

Eligibility comes after ranking

Shared-order history helps the plugin rank potential related products, but a candidate is only returned if it passes the current storefront and merchant-rule checks. This keeps an old historical relationship from surfacing an unsuitable product today.

Products removed automatically

The plugin excludes candidates that are not currently suitable for purchase or display.

Unavailable or hiddenUnpublished, hidden, and otherwise unavailable products are not returned.
Out of stockOut-of-stock products are removed from smart candidate results.
Not purchasableProducts that cannot currently be purchased are excluded.
DuplicatesA product is not returned as a duplicate recommendation for the same source.

Merchant rules also apply

Global exclusions can remove individual products, product categories, or product tags. If you use an optional category or tag matching rule, candidates outside that selected context are also removed before the final result is returned.

  1. Rank candidates from qualifying shared-order history.
  2. Apply availability, visibility, stock, and purchasability checks.
  3. Apply your exclusions and optional category or tag rule.
  4. Use the selected fallback if there are not enough eligible products.

Cached results are checked again

Recommendations are calculated on demand and cached, but eligibility is checked again when outputting the result. A product that becomes unavailable after a cached result was created is not shown just because it was previously eligible.

Next steps

Use these guides to refine how eligible candidates are handled.

Need help with Smart Related Products?

Check the documentation first, or contact us if you still need a hand.

Contact Support