Skip to main content

Shopify App Installation Guide

Learn how to install the RaveCapture Shopify App and start collecting reviews in minutes.

Updated yesterday

Overview

The RaveCapture Shopify App allows merchants to automatically collect and display product and company reviews with minimal setup. Designed to integrate seamlessly into your Shopify store, the app streamlines review requests, UGC collection, and widget installation.

Whether you're a new user or migrating from another eCommerce platform, this guide walks through installation, onboarding, and customization steps to ensure you're up and running quickly.


For Custom App Users:

Why does it say my Script isn't Connected?

  • If your widgets are showing, you don't need to do anything else. You have used an older implementation by adding the JavaScript directly to your theme. liquid file.

  • If your widgets are not displaying as expected, please contact our support team.

Why do I see a connect store section? Isn't my store already connected

  • You may see this message if you are using the custom app.

  • It is not necessary to click the "connect your store" button if you would like to continue using the custom app. This message is for public app users.

  • If you would like to switch over to the public app, please contact our support team.


Step-by-Step Installation

1. Add the App from Shopify

  • Navigate to the Shopify App Store and search for RaveCapture.

  • Click Install to begin.

2. Authorize the App

  • You'll be prompted to approve permissions (access to orders, products, customers, etc.).

  • Click Install App to continue.

  • The app is now connected to your RaveCapture account, and the JavaScript has been installed on your live theme.

  • If you have an existing RaveCapture account, you will be directed to the Shopify integration page in RaveCapture to complete your integration setup.

Order Trigger

Determine when order data will be sent to RaveCapture to create a pending review and/or survey request. There are two available triggers:

  • Order Fulfilled

  • Delivered

** If you are implementing RaveCapture widgets on a non-live theme, you will need to manually add the JavaScript to the theme editor. To add the JS to a non-live theme, navigate to your theme customizer and select "app embeds". Open the RaveCapture Init Scripts and enter your RaveCapture key and link. These values can be found within your RaveCapture account by clicking on Settings in your header>Integrations>Manual. Be sure to click save after adding these values in your non-live theme. You can now move on to Step 4 to add the desired widgets to your theme. Note: This step is only necessary when implementing the widgets on a non-live theme.

3. Onboarding & Account Setup for New RaveCapture Users

  • A RaveCapture account is created automatically, and you'll receive an email with login credentials.

  • Upload your logo.

  • Choose to collect Product Reviews or Company Reviews.

  • Customize your review request email timing and message.

  • Decide whether to enable Auto-Send (can be toggled anytime).

As soon as installation is complete, RaveCapture begins receiving fulfilled or delivered orders (based on your Order Trigger) via Shopify webhooks. Pending review requests will be created subsequently.


Add Widgets to Your Store

4. Product Review Widget (via App Block)

  • Navigate to your Product page template in the Shopify theme editor.

  • Click Add block under any section.

  • Choose the TS Review Widget, then drag it where you'd like it displayed.

5. TrustBadge & Carousel Widgets

  • Repeat the above process, choosing TS Trust Badge or TS Review Carousel as needed.

6. Optional Inline Widgets (Manual Code)

You can also manually add inline widgets by inserting code into your theme files or the theme customizer using a custom liquid section

Product Inline Stars:

<div class="trustspot-inline-product" data-product-sku="{{ product.id }}"></div>

Place directly under {{ product.title }}

Category Stars:

<div class="trustspot-inline-category" data-product-sku="{{ product.id }}"></div>

Insert in product-loop.liquid or product-grid-item.liquid under {{ product.title }}

To customize the styles of your widget, go to the Display Widgets page in-app, click on the widget you want to customize (or add to your theme), and you'll see multiple design options to choose from.


Product Sync & Plan Info

  • RaveCapture automatically syncs your product data after installation.

  • Visit the Product Library in-app to review synced products.

  • Click Sync from Shopify to jump first in the product sync automated queue.

  • Product data is essential for widgets, grouping, and Google Shopping.


Additional Information and Troubleshooting Guide

What does the “Custom App Conflict” message mean?

You’re using an older version of our Shopify integration (called the Custom App). To switch to the public app:

  1. From your Shopify store, navigate to the RaveCapture and install the public app

  2. From your RaveCapture account, uninstall the custom app

Can I use both the Public App and Custom App at the same time?

Technically yes, but it’s not recommended. Doing so may prevent automatic setup (like webhooks and scripts), cause duplicate review requests, or block product syncing. We suggest uninstalling the Custom App after installing the Public App.

Why am I seeing a message about a platform conflict?

You currently have another eCommerce integration (like BigCommerce or WooCommerce) active in your account. To use Shopify, you must fully migrate your store and complete a product re-SKU process. Please review our guide here.

I installed the app, but it says my token is invalid. What should I do?

This means the Shopify connection is broken. Please uninstall and reinstall the RaveCapture app from the Shopify App Store to restore the connection.

Why can’t I click the “Install Script” or “Generate Webhooks” buttons?

These functions are disabled if you still have the older Custom App installed or if you haven’t fully migrated to Shopify from another platform. Resolve the error shown at the top of the page first.

My product sync isn’t working — what should I check?

Make sure you’ve:

  • Installed the Public App

  • Uninstalled the Custom App (using the button in RaveCapture)

  • Have not seen any token errors on the page

Only then can product sync operate using the new GraphQL connection.

How do I know if I’m fully connected?

You’ll see green status indicators confirming that your script is installed and both required Shopify webhooks are connected. If either one is missing, we’ll show a prompt to fix it.


Need Help?

If you encounter issues or have questions during setup:

Did this answer your question?