You have chosen accessories to recommend alongside a product, but customers see an empty space, a different selection or nothing at all. Before installing another app, check which recommendation feature the page uses and where the expected products disappear.
For a UK retailer, the useful outcome is straightforward: someone buying a main item should be able to find a suitable extra, understand whether it fits and add the right version to their basket. A row of attractive photographs is only part of that job.
This guide covers recommendations on Shopify online-store product pages using Shopify Search & Discovery and a compatible theme. If a separate app supplies the suggestions, start with that app’s configuration and support documentation.
Start with one product and one missing recommendation
Choose a product customers can currently buy and a specific item you expect it to recommend. Record both product URLs, the recommendation heading and a screenshot of what actually appears. Note whether you are looking at the published shop or a theme preview.
Keep the test conditions consistent: the same market, customer sign-in state and basket contents. Begin with an empty basket, then repeat after adding the accessory. That gives your developer a repeatable example instead of a general report that recommendations are unreliable.
Also identify who supplies the block. A heading such as “Pairs well with” does not establish whether it comes from the theme, Shopify’s recommendation service or an installed app. Ask whoever maintains the shop to confirm this before changing settings in several places.
Check whether you selected alternatives or add-ons
Shopify distinguishes between two product recommendation intents:
- Related products suggest similar items, including possible alternatives to the product being viewed.
- Complementary products suggest items that go with it. These need manual configuration; Shopify only automatically generates related recommendations within this product-page system.
A different bicycle might be a useful alternative to the one a shopper is considering. A compatible pannier is an add-on. Decide which job the block should do before judging its contents.
Write a simple expectation for your example: “On this bicycle page, show this pannier as a complementary product.” Avoid using “related” loosely in the brief when you specifically mean an accessory. That wording matters when someone checks the saved selection and the theme’s request.
Check whether the suggested product is eligible
Under Shopify’s current Search & Discovery requirements, a recommended product must be Active, published to the Online Store, priced above zero, neither Unlisted nor a gift card, and absent from the visitor’s basket.
Stock rules differ: complementary products need inventory above zero. A sold-out related product can still appear when continuing to sell out of stock is enabled.
Do not change genuine stock or publication restrictions just to fill a recommendation slot. If an accessory is unavailable, select a suitable available replacement. If it is already in your test basket, remove it and repeat the comparison before treating its disappearance as a fault.
For products with options, separately check the size, colour or fitting the customer actually needs. A recommendation should lead to a useful purchase, so review compatibility as well as whether the product appears.
Compare the saved selection with the published page
In Apps > Search & Discovery > Product recommendations, open the affected main product. Check the complementary and related selections separately. For related products, also check whether the configuration allows only custom recommendations or includes automatically generated suggestions.
Then inspect the published theme and the product template used by that item. Shopify requires a compatible theme with the appropriate recommendation section or block added to the product page. A saved product selection alone does not complete the display setup.
Ask your maintainer to check the actual affected URL rather than demonstrating a different product in the editor. Include a second product that works, if you have one. Comparing the two can narrow the investigation to a template, a selection or a product-specific condition.
If a repair needs theme changes, use a duplicate theme for the work and retain a route back to the previous version. Agree how the corrected template will be checked before it replaces the published version.
Ask your developer to trace the recommendation request
If the selected products qualify but remain absent, ask for evidence from the browser request and its response. This is a focused development task: establish what the page asks Shopify for, what Shopify returns and what the theme displays.
Shopify’s Product Recommendations API reference specifies the main product ID and a recommendation intent. The default intent is related. A custom implementation expecting add-ons should explicitly request complementary. For an HTML section response, the request also needs the section ID.
Use the evidence to choose the next step:
- No request: investigate whether the relevant section and its loading code run on that page.
- A request for the wrong main product or intent: correct the value supplied by the theme.
- A successful response with no wanted products: revisit the selected items and their eligibility in the same customer context.
- A response containing the wanted products, but no visible cards: investigate the theme’s rendering and layout.
Shopify’s complementary-product implementation guide explains that its example loads recommendations asynchronously with JavaScript. An initially empty section therefore needs checking after its loading process has run. The guide also recommends handling an empty result without leaving an unhelpful placeholder.
Ask for a short explanation of the cause and the changed component. That makes the fix easier to maintain than an unexplained replacement app. Our web development service covers the implementation behind customer-facing website features.
Make the recommendation useful once it appears
Check the merchandising decision with someone who knows the products. For a pannier, that means confirming which rack it fits and making the relevant compatibility information easy to find. For a replacement filter, it means identifying the correct appliance models. Visual similarity alone is a weak basis for an accessory recommendation.
Shopify’s complementary-product guide suggests placing these recommendations near the main product information and showing two or three by default. Treat that as a starting point for your layout, then test whether customers can recognise and use the suggestions on a phone.
Use a clear heading, legible product information and an obvious route to choose any required options. Avoid crowding the main purchase controls. If the recommendation needs a lengthy explanation before it makes sense, consider whether the product page needs clearer buying guidance.
Test the complete route into the basket
After the repair, repeat your original example on a phone and a desktop browser. Follow the suggestion, choose the required option and add it to the basket. Confirm that the correct item and quantity appear alongside the main product.
Then test a small, purposeful set of cases:
- A product with a deliberately chosen, available complementary item.
- A product without a configured complementary item.
- An accessory already present in the basket.
- A product using another template, if the shop has more than one.
- The customer market and sign-in state involved in the original problem.
Record the expected outcome before each check. Include any quick-add control or option selector used by the recommendation card; opening the correct product page does not prove that those controls work.
Measure engagement after confirming the feature works
Shopify’s Search & Discovery analytics documentation lists recommendation click rate, purchase rate and a low-engagement report for top-selling products. The app’s displayed metrics cover the last 30 days; other periods are available through Analytics > Reports.
For custom implementations, ask the developer to retain the recommendation URLs returned by Shopify, including their tracking parameters. The API documentation identifies those URLs as part of recommendation conversion tracking.
Keep a record of when the repair went live and which products changed. Review engagement alongside stock availability, customer questions and the usefulness of the resulting purchases. A higher click rate alone does not establish that the recommendations help customers choose suitable items.
If your Shopify recommendations still disappear or point shoppers towards unsuitable extras, talk to BuzzBoost. Share an affected product URL, the item you expected to appear and what happened during your test. That gives us a clear starting point for checking the selection, display and buying journey.
Featured image: AI-generated editorial artwork, not a photograph of a real BuzzBoost office, client or result.


