FAQ
Short answers to the questions that come up most. Longer explanations link out.
Getting started
Do I need WooCommerce?
Yes, version 7.0 or newer, and WordPress 6.6 or newer. WooCommerce is a hard requirement: without it, Shaped Recommend shows a notice and does nothing else, and the rest of your site is unaffected.
Do I need Pro to use this at all?
No. The free plugin includes the builder, the Live Preview, storefront rendering, Analytics, the shortcode and the Gutenberg block. Pro adds more filters, sorts, page types, positions, display styles and display conditions, plus the Store Statistics selection method. Free vs Pro.
Can I install Pro without the free plugin?
No. Pro is an add-on to Shaped Recommend, and WordPress won't activate it unless the free plugin is active. Install the free plugin first.
How long does it take to get something live?
About a minute using a template. Go to Recommend → New Recommend, pick a card, and click Save Changes. Quick Start.
Does saving publish straight away?
Yes, for a new Recommendation. Saving tries to make it Active, which means live on your storefront. If it isn't complete enough yet, it's saved as Inactive instead, and the message tells you what to fix. After that, saving an edit keeps whatever status the Recommendation already has.
What it recommends
How does it decide which products to show?
You choose per Recommendation, under How Products Are Chosen. Rules (Default) uses the filters and sorting rules you set. Store Statistics Pro mines your own completed orders for products that are genuinely bought together.
Is there an AI option?
No. Recommendations come from your rules or your orders, so you can always explain why a product appeared.
Does it work on a brand-new store with no orders?
Yes. Rules work from day one. Store Statistics Pro falls back to category and popularity until there's enough order history. The shopper sees a normal block, never an error or an empty box.
Is Frequently Bought Together a Pro feature?
The Frequently Bought Together template and sorting rule are free and never locked. Be aware of how the sort works, though: it reads co-purchase pairs that the Pro add-on mines from your orders. On the free plugin alone nothing collects those pairs yet, so the rule has no data and has no effect on the order. Add a Popularity rule alongside it so the block still has a sensible order. The FBT tutorial walks through it.
Why are my products in a different order every time I reload?
With no sorting rules, matching products come back in random order and are reshuffled on every page view. Add a rule under Sorting, such as Popularity or Price, for a stable order. Sorting.
Can I give one sorting rule more weight than another?
No. Every rule counts the same, and they're blended into one order. You shape the order by choosing which rules to include.
How many products can a block show?
Between 1 and 20, set by Products to Show on Design. The default is 4. The Single-offer card Pro always shows exactly one, and the Bundle box Pro needs at least two or it doesn't render.
Can I force specific products to appear?
Yes, with Pinned Products in Step 1. Pinned products skip the filters and show first, in the order you set. They don't skip the block's product limit. Pinned products.
Placement
Where can a block appear?
On product pages (three free positions, plus After add-to-cart Pro), category and tag archives, the cart (three positions, including the empty cart), checkout Pro and the thank-you page Pro. There's also a popup Pro, and a shortcode and Gutenberg block for anywhere else. Locations.
Does it work with block themes?
Yes. Cart positions render around WooCommerce's Cart block, and checkout positions Pro around the Checkout block. Product and category positions use classic WooCommerce hooks, which a block theme may not fire. For those, place the Shaped Recommend block in the Site Editor. It's free precisely because block-built pages have no classic hooks to attach to. Troubleshooting.
Can one Recommendation appear in several places?
Each Recommendation has one placement: one position with one display. To show the same idea somewhere else, Duplicate it on All Recommendations and change the copy's position. The copy is saved as Inactive, so activate it when it's ready.
Can I use it with Elementor, Divi or Bricks?
Yes, via the shortcode. Set Position On Page to Custom placement · Shortcode, save, copy the [shapedrecommend id="…"] shortcode, and paste it into your builder's shortcode or text element.
Will it replace WooCommerce's own related products?
Only if you ask it to. By default your block appears alongside WooCommerce's. To hide WooCommerce's section, use Settings → General → WooCommerce Default Showcase. Be aware that this hides it on every page, including pages where your own block doesn't show. Replacing Woo Slots.
Coordination
Why do my recommendations disappear as I browse?
If you've turned on Limit recommendations per session, a shopper stops seeing blocks once they've hit that limit for the visit. A visit ends after 30 minutes without activity. Test in a private window to start fresh. If you haven't turned any limits on, see why a block isn't showing.
Why does one of my blocks never show?
There are a handful of likely causes, best checked in order: Why isn't my block showing?
What does "Limit reached" mean?
The Recommendation is Active, but one of your Recommendation Manager limits (blocks per page or recommendations per session) recently held it back. It's based on what actually happened on the storefront, not something you set. Hover the chip to see which limit. Recommendations List.
Are the coordination limits on by default?
No. No repeated products, Limit blocks per page and Limit recommendations per session all ship off, so every eligible block shows. Turn them on under Settings → Recommendation Manager when your pages start to feel crowded. Recommendation Manager.
How do I stop all recommendations at once?
Deactivate the plugin under Plugins. Your configuration is kept. There's no separate store-wide stop switch. To take down one Recommendation, switch it to Inactive on All Recommendations.
Performance
Will it slow my store down?
It's built not to. Blocks are filled in by one batched request per page after the page loads, and a page with nothing to show loads no plugin assets at all. Performance.
Does it work with page caching?
Yes, without excluding anything. The cached HTML contains only a placeholder with no shopper-specific data, and the real products arrive afterwards.
Will it cause layout shift?
Usually not. A block that's certain to show reserves its space before it fills in. A block that depends on a display condition (for example, a cart total) waits hidden instead of reserving space, because for most shoppers the condition won't pass, and an empty space that then collapses would be worse.
Why are my blocks stuck as grey placeholders?
Something is blocking the fill-in request. It's usually an optimisation plugin delaying JavaScript. Troubleshooting.
Analytics
Are the numbers real?
Yes. Every figure comes from a logged event. A figure that can't be measured on your store yet shows a dash rather than a made-up number.
If someone clicks today and buys next week, does it count?
Within limits, yes. The click is remembered for up to 48 hours and matched to the order when it completes.
Why is Analytics empty?
The most common reason is that the scheduled jobs aren't running, so past days never get added up. Troubleshooting.
How far back can I look?
The free plugin shows up to 30 days. Pro Pro adds 90 days, 12 months and all time.
Data and privacy
What does it store about shoppers?
What blocks they were shown, what they recently viewed, which popups they closed, and clicks waiting to be matched to an order. It's kept for 48 hours at most. There's no profile and no cross-site identifier, and nothing leaves your site.
Is it GDPR-friendly?
It hooks into WordPress's personal-data export and erasure tools and registers with the WP Consent API. Uninstalling & Data.
Will deleting the plugin delete my work?
Not by default. Clean-up Data on Deletion is off, so deleting the plugin leaves all your data in place. Turning it on needs administrator permissions and asks for confirmation. Uninstalling & Data.
Can I move my setup to another store?
Yes, with Settings → Export / Import. Licenses never travel; they belong to the site.
Tier and licensing
What happens if I deactivate Pro?
Your configuration is kept exactly as it is. Any Recommendation that uses a Pro feature stops rendering until Pro is back; nothing is downgraded or rewritten. Reactivate Pro and everything returns. Free vs Pro.
What happens if my Pro license lapses?
Nothing your shoppers can see. In this release, every Pro feature keeps working without an active license. A lapsed license stops updates and support: "Every feature keeps working — updates and support have stopped."
Where do I enter my license key?
Settings → License, once Pro is installed. On the free plugin, that tab only shows the upgrade offer. Activating a license needs administrator permissions.
Roadmap
Do you have slide-ins, carousels or a mini-cart panel?
Not in this release. The builder deliberately doesn't show controls for features that aren't built yet. A popup Pro is available today. Free vs Pro.
Can it apply a discount to a bundle?
No. Recommendations show products; they don't attach discounts. A bundle box shows a struck-through "was" total only when the items really have sale prices, and never invents a discount.
Is there A/B testing?
Not yet. Until then, change one thing at a time and compare weeks in Analytics.
Still not answered?
- Troubleshooting: symptom by symptom
- Glossary: what a word means here
- Contact support