The Product Recommendations block shows a personalised set of products inside the Account Sidebar. This block is visible to all customers, logged in or not.
How the Recommendations Are Generated
This block uses Shopify's built-in product recommendations. Shopify automatically generates recommendations based on signals like viewing behaviour, sales data, and relationships between products in your catalogue. You don't need to manually pick which products appear.
If you want more control over which products are recommended, you can install Shopify's free Search & Discovery app. It lets you manually set complementary and related products on any product, which then feed into the recommendations shown here. See the "Customising Recommendations" section below.
How to Configure the Product Recommendations Block
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Account Sidebar.
Click the Blocks tab.
Find the Product Recommendations block and click on it to expand its settings.
Make sure the block toggle is turned on.
Set the Section Title and Number of Products (see Field Reference below).
Click Save.
Field Reference
Field | What It Does | Example |
Section Title | The heading shown above the product grid in the sidebar. Defaults to "Recommended for You". | "Picked for You", "You Might Like" |
Number of Products | How many products to show in the block. Up to a maximum of 8. | 4 |
Customising Recommendations with Search & Discovery
By default, Shopify decides which products to recommend based on automatic signals. If you want to influence what appears, install the free Shopify Search & Discovery app from the Shopify App Store.
Once installed, you can:
Set complementary products on any product. These are products customers commonly buy together, e.g. a candle and a wick trimmer.
Set related products on any product. These are products in the same category that customers may want to consider as alternatives.
Adjust search and filter behaviour across your store at the same time.
To set complementary or related products:
In your Shopify admin, go to Apps > Search & Discovery.
Click the Recommendations tab.
Pick a product and add its complementary or related products.
Save your changes.
These manual recommendations are picked up automatically by the sidebar block. You don't need to change anything in Mage Loyalty.
Common Mistakes to Avoid
Common Mistake
Shopify's algorithm needs traffic and sales data to generate good recommendations. On a brand-new store with little activity, the block may show fewer products or feel less relevant. Install Search & Discovery to set manual recommendations until your store has enough data.
Common Mistake
Setting Number of Products too high: showing 8 products takes up a lot of vertical space in the sidebar. Most stores get the best balance with 4 to 6.
Common Mistake
Product recommendations only include products with the Online Store sales channel enabled. Products restricted to only POS or Wholesale will not appear.
CSS Reference
The product recommendations block uses Mage's generic sidebar product card classes as well as their own exclusive product card classes as shown below:
Class | What it targets |
| The outer section wrapper around the whole block. |
| The section title (your Section Title text). |
| An individual product card inside the carousel. |
| Wrapper around the loading skeleton shown while recommendations are being fetched. |
| A single placeholder tile inside the loading skeleton. |
Troubleshooting
The block is enabled but showing no products
Shopify needs at least some product catalogue and traffic data to generate recommendations. On very new stores the block may render empty. Try installing Search & Discovery and manually setting complementary or related products on a few products.
Make sure the products in your store have the Online Store sales channel enabled. Products restricted to other channels won't appear.
The recommended products feel irrelevant
The default recommendations come from Shopify's algorithm. The more traffic and orders your store has, the better the recommendations become. To take direct control, use the Search & Discovery app to set complementary and related products manually.
Changes to Search & Discovery aren't reflected in the block
Recommendations can take a short while to propagate. Refresh the storefront after a few minutes.
Clear your browser cache or open the storefront in an incognito window to rule out caching.
Still need help or can't find the answers you're looking for? Reach out to the Mage Loyalty team through our live chat support.