Skip to content
English
Sign in
Learning Hub
  • There are no suggestions because the search field is empty.

Shopify - Product Reviews Integration Checklist

Before going live, work through each item below. We've grouped them into the order you'll most likely complete them, with what to check and how to verify each one.


 

1. Scripts & Code Placement

☐ Product catalog script added to the product page template Confirm the catalog script is present on the same template that renders your product pages (the Custom Liquid block for Shopify 2.0 themes, or product-template.liquid / your theme's equivalent for older themes). If you have multiple product templates, verify the script is on each one your products actually use.

☐ Product Review Display Widget <div> placed on the product page Make sure the <div id="RR_PR_Widget_Wrapper"></div> container exists on the template and sits where you want reviews to render. The script won't display anything without this container, so check that the ID matches exactly — a typo here is the most common reason a widget silently fails to load.

2. Configuration Values

☐ Shopify store URL has been updated Verify your actual store URL is set in the configuration (not a placeholder or a staging/dev URL). If you recently migrated domains or use a custom domain, double-check it points to the live storefront customers will visit.

☐ YOUR_SEO_NAME replaced with your ResellerRatings SEO name Search the pasted script for the literal text YOUR_SEO_NAME and confirm none remains — it should be replaced with your actual ResellerRatings SEO name everywhere it appears. Leaving the placeholder in is a frequent cause of reviews not loading or loading from the wrong account.

☐ Product image URL is displaying correctly Load a product page and confirm the product image referenced by the widget renders without broken-image icons. Check that the URL resolves to a live, publicly accessible image and that it reflects the correct product.

3. Data & Automation

☐ Shopify webhook review trigger configured Confirm the webhook that triggers review requests is set up and active in your Shopify settings. Verify it's pointing to the correct endpoint and fires on the intended event (typically order fulfillment or completion). Without this, no new review invitations will be sent.

4. Final Verification

☐ Product reviews displaying correctly on the storefront Visit several live product pages — ideally a mix of products with reviews and without — and confirm:

  • The widget loads and renders without console errors.
  • Existing reviews and star ratings appear and are accurate.
  • A product with no reviews yet displays gracefully (an empty state or invitation, not a broken layout).
  • Placement looks correct on both desktop and mobile.

 

Troubleshooting Quick Reference

If something isn't working after you've checked the boxes above:

  • Widget doesn't appear at all → Confirm the <div> ID is spelled exactly right and the catalog script is on the same template.
  • Widget appears but stays empty → Check that YOUR_SEO_NAME was fully replaced and the store URL is correct.
  • Reviews load from the wrong store/account → Re-verify the SEO name and store URL values.
  • No new review requests going out → Re-check the webhook trigger configuration and that it's enabled.
  • Broken product images → Verify the image URL resolves and is publicly accessible.