- DarkLight
Builder.io - Integration Guide
- DarkLight
Implement Yotpo through Builder and easily display reviews from Yotpo on your Builder pages.
How it works
Drag and drop a Yotpo app template onto any Builder page to collect product reviews and highlight existing reviews for specific products on any part of your storefront. You can completely customize the look and feel of the Reviews Widget so that every aspect matches your brand aesthetic. You can also A/B test how the reviews appear and where they appear to have the most impact.
We recommend using the services of a developer or contacting the Page Builder App team for the purpose of integrating this customization into your website.
Integrating Yotpo and Builder
You have two ways to add the Yotpo app template to your Builder content:
- Using the Yotpo native Reviews Widget
This template loads much faster than the generic Reviews Widget, as it is native to Builder using Yotpo’s APIs. - Using the Yotpo generic Reviews Widget
Builder’s native embed template covers many of the most popular use cases (e.g. displaying and collecting reviews) but if there is a feature or capability missing that you need, then use the generic widget.
Using the Yotpo native Reviews Widget
To use the Yotpo native Reviews Widget on product pages:
- Log into your Builder account.
- Click Import from: Apps. A popup opens.
- Select Yotpo Product Reviews.
- Drop the app template anywhere on the page.
- On the side panel, navigate to the Options tab.
- Add the app key and, optionally, the Product ID (the product for which you want to collect and/or display reviews), Product URL, and Product title. How to find these values Please note:If using the Builder.io app for Shopify, the product id, product URL, and product title fields can be left blank when used on product pages as it will automatically pick up the product when used on product pages.
- You should see your app template displaying your Yotpo review widget. Using Builder, you can now completely customize the look and feel of the Yotpo reviews, and even test different variations.
To use the Yotpo native Reviews Widget on other pages or sections:
- Log into your Builder account.
- Click Import from: Apps. A popup opens.
- Select Yotpo Product Reviews.
- Drop the app template anywhere on the page.
- On the side panel, navigate to the Options tab.
- Add the app key, Product ID (the product for which you want to collect and/or display reviews), Product URL, and Product title. How to find these values
- You should see your app template displaying your Yotpo review widget. Using Builder, you can now completely customize the look and feel of the Yotpo reviews, and even test different variations.
Using the Yotpo generic Reviews Widget
To use the Yotpo generic Reviews Widget:
- Log into your Builder account.
- Click Import from: Apps. A popup opens.
- Select Yotpo generic reviews widget.
- Drop the app template anywhere on the page.
- On the side panel, navigate to the Options tab.
- Add the app key, store domain, and product handle. How to find these values
- Optionally, you can add additional fields you'd like to capture in the form. See this guide for information about what options the sub-fields accept.
- You should see your app template displaying your Yotpo review widget. Using Builder, you can now completely customize the look and feel of the Yotpo reviews, and even test different variations.
Required values
Required values for Yotpo native Reviews Widget:
Item | Required for | How to find |
---|---|---|
Yotpo app key | Using the Yotpo native Reviews Widget on any pages or sections | See Finding your Yotpo App Key and API Secret |
Product ID | Using the Yotpo native Reviews Widget on pages other than product pages | Navigate to your Shopify product list, select the product, and copy the ID from the address bar. The ID is the last part of the URL. |
Product URL | Using the Yotpo native Reviews Widget on pages other than product pages | This is the URL for your product page (eg. https://my-site.myshopify.com/products/product-name). |
Product title | Using the Yotpo native Reviews Widget on pages other than product pages | This is the name of your product. To find the exact tile, navigate to your products in your Shopify Admin, select the specific product, and copy the text in the title field. |
Required values for Yotpo generic Reviews Widget:
Item | Required for | How to find |
---|---|---|
Yotpo app key | Using the Yotpo native Reviews Widget on any pages or sections | See Finding your Yotpo App Key and API Secret |
Store domain | Using the Yotpo generic Reviews Widget | The domain name of your store, like www.mystore.com or my-store.myshopify.com. |
Product handle | Using the Yotpo generic Reviews Widget | When you create a new product in Shopify, it also creates a product handle that is the same as the product name. For example, if your product name is “My Awesome Product”, then the handle would be “my-awesome-product.” If you’ve edited your product handle, you can also find it on your product page in Shopify and look for the Edit Website SEO Section at the bottom of the page. |