Skip to main content

Fix a blank recommendations widget — Rocketworks Tutorials

Fix a blank recommendations widget

On this page

A recommendations widget shows nothing when it has nothing worth recommending — it never shows an error to shoppers. This tutorial explains the model status badges, what Rebuild model does and how to work out why a widget is empty.

Steps in short

  1. Check the Model status badge on the Overview tab.
  2. Rebuild model re-syncs your catalogue, then rebuilds.
  3. Go through the common reasons a widget is empty.
  4. Set the widget’s Min Height to 100 px.

1. Read the model status badge

BadgeWhat it means
Up to dateThe last rebuild finished. Check Model rebuilt for when.
Rebuilding…A rebuild is running. The page doesn’t refresh itself, so reopen it in a minute.
Last rebuild failedA red alert shows the error. Press Rebuild model to try again.
Waiting for first rebuildConnected, but no model yet. Press Rebuild model.
Not connected yetThe store isn’t connected. Refresh the page — opening it connects the store.
Model status and recent rebuilds
Model status and the Recent rebuilds table, with a failed run between two good ones. Sample data.

2. Know what Rebuild model does

Rebuild model syncs your catalogue and then rebuilds the model in the background. It runs automatically every six hours, and the catalogue syncs every hour. Press it after adding products or big catalogue changes — new products can only be recommended after a rebuild. If one is already running you’ll see “A rebuild is already running”.

3. Work through the checklist

  1. Is the placement switched on in Settings?
  2. Has the AI Recommendations page been opened since installing? That connects your store.
  3. Has the first model been built? Press Rebuild model.
  4. On a new store, trending and cart widgets stay empty until shoppers have viewed or bought something.
  5. Does the product share tags or categories with others? With none — and no views or orders yet — there’s nothing to link it to.
  6. Is everything it links to out of stock while Hide out-of-stock products is on?
  7. On the product template, is the Product Review element’s Plugin set to AI Product Recommendations?
  8. Changed a setting just now? Open the AI Recommendations page to apply it, or wait up to an hour.

4. Tidy up empty space

If there’s a blank gap where the widget would be, that’s the page-builder element’s Min Height, not an error. Set it to about 100 px under Advance → Container.

Good to know

  • On a store with its own domain, the widget only loads once that domain is connected to your Orbit store.
  • Still stuck? Email support@rocketworks.dev with your store URL and a screenshot of the Overview tab.

AI Product Recommendations£39.99 a month · 7-day free trial · billed through Orbit

Still stuck?

Email support@rocketworks.dev with your store’s web address and a screenshot. You’ll hear back from the people who built the plugin.

We value your privacy

We use cookies to improve your experience, analyse traffic, and personalise content. You can accept all, reject non-essential, or manage your preferences.