Overview
Plan scope for the examples below: Seed supports core recommendation rules, with up to three active rules and one offer per placement. Purchase-history suppression and association mining require Growth or Pro; AI rule generation, the Drafts queue and AI combo reasons require Pro.
SmartCart delivers Magento 2 add-on recommendations in your shoppers' path at the moment they're most likely to add something extra. When a customer has items in their cart, SmartCart evaluates your rules, picks the most relevant complementary products, and shows them as add-on tiles. The module works locally with no third-party calls at runtime - you decide which products appear and when.

Every recommendation is entirely rule-based. You control which products appear through a rule editor with three trigger types (specific SKUs in cart, category in cart, or attribute match) and three pool types (specific products, a category, or an attribute value). Optional guardrails keep out-of-stock, already-in-cart, or previously-purchased products off the list automatically.
A separate offline toolset - association mining and an optional AI provider - can analyse your order history and propose draft rules for your review. You approve or reject each draft; nothing goes live without your sign-off.
This module helps you:
- Present relevant add-on products in the cart, mini-cart, and checkout sidebar without touching theme templates
- Suppress products a shopper already owns, has already added, or has dismissed - keeping suggestions fresh and useful
- Build recommendation rules manually or let the system propose them from your order history
- Track impressions, clicks, add-to-carts, and revenue per rule so you can see what's working
- Restrict offers by customer group, cart subtotal threshold, or coupon status
- Explain why each suggested product belongs in the cart with AI-written reasons tailored to the shopper's specific items
- Group suggestions under a clear heading so shoppers scan by theme instead of reading each tile independently
- Show star ratings and a one-line review snippet on each suggestion so shoppers can judge relevance at a glance
When to use this
Use SmartCart when you want to:
- Surface complementary accessories or consumables at the point in the journey where the shopper has already committed to buying
- Replace a static cross-sell block with context-aware suggestions that respond to what's actually in the cart
- Test which add-on products convert best - rule-level stats show impressions, add rate, and purchase rate over 30 days
- On Growth or Pro, avoid showing returning customers products they already bought with purchase history suppression
- On Growth or Pro, mine product associations from order history; Pro adds draft-rule review
Key capabilities
- Rule-based recommendations - define triggers (SKU, category, attribute) and pools (specific products, category, attribute) per rule
- Three placement zones - cart page, mini-cart, and checkout sidebar, each independently enabled
- Guardrail filtering - automatically removes out-of-stock, already-in-cart, excluded, and incompatible candidates
- Dismissal memory - dismissed offers stay hidden for a configurable number of hours per shopper, per store
- Purchase history suppression (Growth or Pro) - skip products the shopper has already ordered, matched by customer ID (guest email matching requires Pro)
- Performance stats - 30-day impressions, add rate, purchase rate, and revenue visible on the Rules grid
- Offline association mining (Growth or Pro); AI rule generation (Pro) - mine co-purchase associations from order history, optionally enrich with AI tags, generate draft rules for admin review
- Draft approval workflow (Pro) - generated rules require explicit approve or reject before going live
- Find pairing guidance (Pro) - scans your product, category and selected CMS text for compatibility advice, quotes the passage it came from, and queues it for review. The scan never changes your recommendations
- Event tracking - impressions, clicks, dismissals, and purchases logged with placement context for analysis
- ProfitEasy integration - SmartCart-attributed revenue appears as a
smartcartsource bucket in ProfitEasy reporting - AI combo reasons (Pro) - Generates short, specific explanations for each suggestion (e.g. "Both are waterproof and UV-resistant") so shoppers understand the recommendation at a glance
- Grouped suggestion headings - Suggestions are grouped by recommendation theme with a short heading (e.g. "Complete your travel workout kit") so shoppers scan by context instead of reading every tile
- Star ratings on offer tiles - Each suggestion shows a compact star rating and review count when review data is available
- Review snippet - Optional one-line excerpt from a real customer review shown below each suggestion tile
In this guide
This guide is split across several pages so each one stays quick to read and easy to search. This page covers what SmartCart does, how to install it and the frequently asked questions. The detailed instructions are on these pages:
- SmartCart: Set Up Rules, Suppression and AI Drafts: Turn SmartCart on, build recommendation rules, restrict offers, suppress owned products, and use AI drafts and reasons. Covers Turn SmartCart on and place it on the cart page, Create a manual recommendation rule, Restrict offers by customer group and minimum cart value, Use purchase history suppression to avoid re-suggesting owned products (Growth or Pro), Generate rule drafts from order history (Pro), Find pairing guidance in store content (Pro), Enable AI-written reasons for cart suggestions.
- SmartCart: Settings and Features Reference: Every SmartCart settings group explained: placements, presentation, matching, eligibility, empty cart, bundles and checkout surfaces. Covers Features reference.
- SmartCart: Advanced Setup, Tips and Troubleshooting: Advanced configuration, best practices, and answers to common SmartCart problems. Covers Advanced configuration, Tips & best practices, Troubleshooting.
Installation
Bought on Adobe Commerce Marketplace? Your purchase comes with a Moogento account: set your password from the activation email, then follow the steps below with the Composer keys and licence key in My Plugins. If the email has not arrived, contact Moogento support.
SmartCart installs via Composer, then activates with a license key from your Moogento.com account. The whole flow takes about 5 minutes.
Prefer a hands-off setup? Our team can install and configure the extension for you - see the paid install service.
Step 1: Get your Composer keys from Moogento.com
- Sign in at https://www.moogento.com and open My Plugins in your account menu.
- Find SmartCart in the list of plugins you own.
- Generate (or reveal) the Composer access keys for that plugin - a public key and a private key.
- Add your install domain to the key. Each Composer key is tied to a specific domain - if you're installing on
yourstore.com, addyourstore.comto the key's allowed domains. The Composer download will be rejected on any other domain.
If you run staging and production on different domains, add both - separate keys per environment are fine too.
Step 2: Install the module with Composer
From your Magento 2 root directory:
composer require moogento/m2-smartcart
When Composer asks for credentials, paste the public key as the username and the private key as the password. They'll be cached in ~/.composer/auth.json for future runs.
Step 3: Enable the module in Magento
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
If you run php bin/magento module:status Moogento_Smartcart you should see it listed as enabled.
Step 4: Add your license key in the Moogento admin
- For a direct purchase, copy the SmartCart license key from My Plugins at moogento.com. For a Marketplace purchase, check your Moogento account for an issued key and contact Moogento support if it is missing.
- Open Stores > Configuration > Moogento > License in Magento Admin. Add the Installation Domain shown on this page to the key in your Moogento account.
- Paste the key into the key field and click Add key.
- Under Registered Keys for this Installation, confirm that SmartCart appears with the correct plan.
The license validates within a few seconds. You should see the module's status flip to active. If it stays inactive, double-check the domain on the license matches where you've installed - domain mismatch is the most common cause.
Setup overview
Most setup happens in:
Stores > Configuration > Moogento > SmartCart
The major configuration sections are:
- Setup: General - master on/off switch, offer limit, cache TTL, and logging level
- Where: Placements - choose which zones (cart page, mini-cart, checkout sidebar) show recommendations
- Look: Presentation - grouped suggestion headings, star ratings, and review snippets
- Sources: Suggestions & Matching - product sources, attribute compatibility, Don't Mix category groups, and co-purchase associations
- Limits: Eligibility & Suppression - customer group restrictions, minimum cart subtotal, excluded SKUs and categories, purchase history suppression
- Extra: Empty Cart Experience - turn empty carts into discovery pages with a bestseller section, popular categories, and optional continue button (Growth+)
- AI: Rules - configure an AI provider and trigger rule generation from order history
- Pro: AI Draft Automation - auto-approve high-confidence drafts (Pro plan)
- Pro: Pairing Guidance - review compatibility advice found in your store text (Pro plan)
- Pro: Free Shipping & Tier Boost - show a progress bar to free shipping and suggest products to reach the next tier
- Pro: Smart Bundles - let shoppers add multiple recommendations at once with an automatic discount
- Pro: Extra Add-on Surfaces - display Everyday Essentials and Complete With surfaces
- Extra: Empty Cart Experience - turn an empty cart into a discovery page (Growth and Pro plans)
- Pro: Focused Checkout - hide navigation distractions on the checkout page
Rules and draft review live under the Moogento menu:
- Moogento > SmartCart > Rules - create, edit, enable, disable, and delete recommendation rules
- Moogento > SmartCart > Drafts - review, approve, or reject AI-mined draft rules
- Moogento > SmartCart > Pairing Guidance - Pro only: review compatibility advice found in store content, and manage aliases
- Moogento > SmartCart > Stats - view aggregated performance data. "Units sold" is the quantity of suggested items ordered, so a line of 5 counts as 5. "Times added to cart" counts add-to-cart actions, not quantity. "Order credits" counts one per order for each rule, placement and surface that helped it, so one order can earn more than one credit; the "Orders SmartCart played a part in" row gives the distinct order count
- Moogento > SmartCart > A/B Tests - manage cart recommendation experiments
Common setups
- Turn SmartCart on and place it on the cart page
- Create a manual recommendation rule
- Restrict offers by customer group and minimum cart value
- Use purchase history suppression to avoid re-suggesting owned products (Growth or Pro)
- Generate rule drafts from order history (Pro)
- Find pairing guidance in store content (Pro)
- Enable AI-written reasons for cart suggestions
FAQs
How do I add contextual cart recommendations to my Magento 2 store?
Install SmartCart, create at least one recommendation rule under Moogento > SmartCart > Rules, and enable the module at Stores > Configuration > Moogento > SmartCart > Setup: General. Offers appear automatically on the cart page without any template changes.
Why are no recommendations showing even though the module is enabled?
SmartCart needs at least one active rule whose trigger matches the current cart contents. Go to Moogento > SmartCart > Rules and confirm a rule is enabled, scoped to the right store view, and that the trigger SKU, category, or attribute is present in the shopper's cart.
Can I show add-on suggestions in the mini-cart or during checkout?
Yes - SmartCart supports three independent placement zones: the cart page, the mini-cart slide-out, and the checkout sidebar. Enable each one at Stores > Configuration > Moogento > SmartCart > Where: Placements. Mini-cart and checkout placements show at most one offer and only rules with Essential intent.
How does SmartCart choose which products to recommend?
SmartCart evaluates your active rules in priority order against the current cart contents. Each rule has a trigger (which products or categories must be in the cart) and a pool (which products to suggest). Only in-stock, eligible, and compatible candidates from the winning rules are shown.
Does SmartCart work with Hyvä, Luma, or Porto themes?
SmartCart is compatible with Luma and Porto themes out of the box. SmartCart also ships its own Hyvä layouts and templates directly in the module, so no separate compatibility layer is needed - you still need a genuine Hyvä theme installed on your store to use them. Contact moo@moogento.com if you run into a rendering issue on your specific Hyvä version.
Will shoppers keep seeing a suggestion for something they already bought?
Not on Growth or Pro if you enable purchase history suppression. Set Stores > Configuration > Moogento > SmartCart > Limits: Eligibility & Suppression > Enable: Purchased Product Suppression = Yes and SmartCart will automatically skip products the shopper has ordered before.
Can I hide recommendations when a discount code is applied?
Yes. Set Stores > Configuration > Moogento > SmartCart > Limits: Eligibility & Suppression > Disable: When Coupon Applied = Yes. All recommendations will be hidden for that cart session while a coupon code is active.
How do I know which recommendation rules are performing best?
Enable event tracking at Stores > Configuration > Moogento > SmartCart > Setup: General, then check the Rules grid at Moogento > SmartCart > Rules. The grid shows 30-day impressions, add rate, purchase rate, and revenue per rule, updated every 15 minutes.
Related guides
- Pulse - real-time dashboard with a SmartCart ecosystem widget showing add-on performance at a glance
- ProfitEasy - revenue attribution reports with a dedicated SmartCart source bucket
- SmartListings - category-ranked product discovery for SmartCart sources
Need help?
- moo@moogento.com
- Include:
- Magento version
- Module name
- What you're trying to do
