Why aren’t my reviews showing on the storefront?

Introduction

If your reviews aren’t appearing on your product pages, homepage, or collection pages, don’t worry — it usually comes down to widget placement, moderation settings, or product/template setup. Roadmap Reviews only display when the correct app block or code widget is added and the review is approved (if moderation is required).

1. Check Widget Placement

• On Product Pages (PDPs):
  • Make sure the Roadmap Reviews block is added to your product page template in Shopify’s theme editor.
  • Without it, reviews won’t display even if they exist.
• On Collection Pages / Product Cards:
  • You must paste the review widget code into your product card template (card-product.liquid or similar).
  • Without the snippet, star ratings and counts won’t appear in collections.

👉 Fix: Add the Reviews block or code snippet where needed.

2. Confirm Product Assignments

• Reviews are tied to products by their Shopify ID/handle.
• If reviews are imported with the wrong product reference, they won’t appear.
•  👉 Fix: Double-check product mappings in your import CSV or review setup.

3. Check Review Moderation Settings

• If auto-publish is disabled, reviews must be manually approved before appearing.
• If auto-publish is enabled, only reviews meeting your minimum star threshold (e.g. 4★+) will publish automatically.
•  👉 Fix: Go to Roadmap → Reviews → Moderation and approve pending reviews.

4. Shared Reviews Setup

• If you’re expecting reviews to appear across multiple products, confirm that Shared Reviews groups are set up correctly.
•  👉 Fix: Go to Roadmap → Reviews → Shared Groups and ensure the products are linked.

5. Verify Styling & Template Issues

• Some Shopify themes require a dedicated Roadmap review template for correct display.
• If reviews aren’t rendering, the wrong template may be applied.
•  👉 Fix: In Shopify Admin → Products → [Product] → Template → assign the correct template or contact Roadmap Support to set one up.

6. Cache or Theme Delays

• Sometimes reviews don’t appear immediately due to browser or theme caching.
•  👉 Fix: View your site in a private/incognito browser or clear your cache.

Common Questions

• Do I need to approve reviews before they appear?
  • Yes — unless you’ve enabled auto-publish with a star threshold.
• Can imported reviews show immediately?
  • No — imported reviews must be approved manually.
• Why do reviews show in the admin but not on PDPs?
  • Because the Reviews block hasn’t been added to the PDP template.
• Why aren’t ratings showing in collections?
  • You need to paste the Roadmap review widget code into your product card template.

Summary

If reviews aren’t showing:

• ✅ Add the Reviews block to PDPs.
• ✅ Paste the widget code into collection product cards.
• ✅ Check moderation/auto-publish settings.
• ✅ Confirm shared review groups are set up.
• ✅ Assign the correct template if needed.

👉 Next step: Approve any pending reviews in the admin, then confirm your widget placement.