How to Install Reviews for BigCommerce Blueprint Themes

Overview

Sendlane Reviews is the perfect complement to any BigCommerce store and provides plenty of widget customization options to seamlessly blend with your website's branding! Read on to learn how to install Sendlane Reviews in your BigCommerce store's Blueprint theme. If you use a Stencil theme in your BigCommerce store, follow this installation guide.

In This Guide

1. Install the Product Review Widget Script
2. Install the Product Review Widget Element
3. Install the Star Widget Element
4. Uninstall Existing Reviews Widget

• Next Steps
• Troubleshooting

1

 Install the Product Review Widget Script

The product review widget script connects your BigCommerce store to your Sendlane account.

Copy the Product Review Widget Script

1. Login to Sendlane
2. Click the Reviews icon
3. Click Product Review
4. Click Get Widget Code
5. Under Widget Script, click Copy Code

Paste the Product Review Widget Script

1. Login to BigCommerce
2. Click Storefront
3. Click Script Manager
4. Click Create new script
   1. Script Name: Sendlane Reviews
   2. Location on Page: Head
   3. Select pages to add script: Storefront pages
   4. Script Category: Essential
   5. Script type: Script
   6. Script: Paste the copied product review widget script
5. Click Save

2

 Install the Product Review Widget Element

The product review widget element tells your BigCommerce store where to display product reviews for individual products on your product pages. You can install the widget element in the default product page template file, and Sendlane Reviews will automatically only display reviews for the product that appears on the page.

Copy the Product Review Widget Element Code

1. Login to Sendlane
2. Click the Reviews icon
3. Click Product Review
4. Click Get Widget Code
5. Under Widget Element, click Copy Code

Paste the Product Review Widget Element Code

1. Login to BigCommerce
2. Click Storefront
3. Click Themes
4. Click Advanced
5. Click Edit Theme Files
6. Click Templates
7. Click Pages
8. Click product.html
9. Press CTRL + F or Command + F to bring up the search and find window
10. Copy and paste {{{region name="product_below_content"}}} into the search box to locate the region name tag
11. Paste the product review widget element code directly after the region name tag
12. Click Save & Apply File

To check that the review script and widget were installed correctly, click Preview Store, then click on a product and scroll down.

If you’ve imported reviews, you should see any existing reviews for the product you clicked on.

If you have not imported reviews, you should see a section to write the first review for the product you clicked on.

3

 Install the Star Widget Element

The star widget element displays a product’s average star rating on individual product pages and on product category pages.

Because BigCommerce themes vary, you may need to try more than one location when installing the star rating widget.

Copy the Star Widget Code

1. Login to Sendlane
2. Click the Reviews icon
3. Click Product Review
4. Click Product Review
5. Click Get Widget Code
6. Click the Show mini-mode checkbox
7. Under Widget Element, click Copy Code

Install the Star Widget

1. Login to BigCommerce
2. Install the star rating widget on individual product pages:
   
   1. Click Storefront
   2. Click Themes
   3. Click Advanced
   4. Click Edit Theme Files
   5. Click Templates
   6. Click Components
   7. Click Products
   8. Click product-view.html (if you do not see a product-view.html file, look for a file with the word product in the name)
   9. Paste the star widget snippet where you'd like the star widget to appear on the product page
   1. The two most common places for the star widget are under the product’s price or title. Click into the code, press CTRL + F or Command + F, and search for product__price div for the product's price or {{product.title}} for the product’s title.
3. Install the star rating widget on product category pages
1. Click Products
2. Click Category
3. Click product-listing.html
4. Paste the star widget snippet where you want the product’s average star rating to appear on the collections page.
4. Click Save

To check that the star widget was installed correctly, click Preview Store, then click on a product.

4

 Uninstall Existing Reviews Widget

If you are using BigCommerce's native reviews platform, uncheck the Product Reviews checkbox in your comments' settings. See BigCommerce's guide for more information.

If you are using another reviews platform, follow the instructions provided by your platform to uninstall. Check out the uninstallation guides for common reviews platforms here:

• Yotpo
• Stamped
• Judge.me*
• Okendo*

*Uninstall the widgets from locations noted in the installation guide

Troubleshooting

My theme doesn't have a product-view.html file!

BigCommerce theme file names can vary across themes. Look for files with the word "product" in the name.

My product collection pages are displaying the same score in the star widget for all products!

Changing the product value in the star widget snippet may solve the issue of collection pages displaying the same star rating for all products.

Your store’s theme may not recognize the default value of product.id because your theme assigns a different value (such as product, id, or item.id) for your product elements.

Try replacing product.id in the star widget with product, id, or item.id.

My theme doesn't have any of the recommended files or tags to place a widget!

Because themes vary widely, you may have to experiment with widget placement. If you already use another reviews product, try placing your widget scripts in the exact same spot your existing widgets were installed in.