Getting Started with ReviewInsights

Everything you need to set up the app, manage reviews, configure display settings, build product bundles, and integrate widgets on your storefront — by Galaxy Web Links.

1. Install & Initial Setup

After installing ReviewInsights from the Shopify App Store, open the app from your Shopify admin. Complete the subscription step if prompted, then explore the four main areas from the sidebar:

Reviews Overview — view, moderate, import, and export reviews
User Guide — in-app documentation (same content as this page)
Create Bundle — group products for shared review syndication
Settings — customize widget appearance and behavior

Before going live, add at least one review widget to your theme (see Section 5 below) and configure your display preferences in Settings.

2. Reviews Dashboard

The Reviews page is your central hub for viewing, moderating, and managing every review across products and bundles.

Review Summary

At the top of the page, the Review Summary card shows:

Average Rating — overall star rating across all approved reviews
Total Reviews — cumulative count of all stored reviews

Collecting Reviews

Reviews can be added in two ways:

Storefront Submit Form — customers write reviews through the Star Rating widget on your product page. Submissions arrive as Pending until you approve them.
Import CSV — bulk-import reviews using the CSV upload feature. Download the sample CSV template first to ensure correct column formats.
Export CSV — download all reviews as a backup or for external processing.

Review Tabs

The dashboard is divided into three tabs:

All Reviews — every review across all products. Approve, reject, delete, or edit any review (title, content, author, rating, email, status).
Product Ratings Overview — products with aggregated ratings. Click a product to view and moderate its reviews only.
Bundle Review Approvals — bundles you've created. Click a bundle to moderate reviews syndicated across its products.

3. Create Bundle

Group two or more products so customers can leave reviews on the collection as a whole, with automatic review syndication across all bundled products.

Creating a Bundle

Navigate to Create Bundle from the sidebar.
Enter a Bundle Name (e.g., "Summer Starter Kit").
Use the product picker to Add Products. A minimum of two products is required.
Save the bundle.

Editing a Bundle

Existing bundles can be renamed, expanded with more products, or have products removed (a minimum of two must remain).

Review Syndication

When review syndication is enabled for a bundle:

A review submitted for any product in the bundle arrives as Pending.
When you Approve it from the Bundle Review Approvals tab, the app publishes it to all other products in that bundle automatically.
This ensures all bundled products share social proof without manual duplication.

4. Settings — Review Display

Customize how review widgets look and behave on your storefront.

Text Styling

Customer Review Widget Heading — title at the top of the full review widget (e.g., "Customer Reviews")
Star Rating Widget Heading — label for the compact star-rating widget

Layout & Display

Display Mode — Grid (card layout) or Slider (horizontal carousel)
Visible Reviews Count — reviews shown per page or slide
Border Radius — corner rounding on review cards

Color Scheme

Customize star color, background, heading, and card colors. A live preview updates as you change values.

5. Standard Liquid Theme — Storefront Widgets

For stores running a standard Liquid theme, embed widgets via the Theme Editor:

Go to Shopify Admin → Online Store → Themes → Customize
Navigate to a product page template and click Add Block
Insert one of three app blocks:
- Star Rating — average score, review list, and customer submission form (reviews saved as Pending)
- Simple Rating — compact numerical rating badge
- Review Widget — full review list with layout from Settings
Settings changes reflect across all blocks instantly — no re-embedding needed.

6. Hydrogen / Headless Integration

For headless Hydrogen storefronts, ReviewInsights offers iFrame widgets and JSON APIs.

Option A — iFrame Widgets

Copy-paste embed snippets into your Hydrogen components:

1. Review Slider (ReviewWidget) — horizontal review slider for a dedicated reviews page:

https://[your-store].myshopify.com/apps/productreview/gwl-review-widget

<iframe
  src="https://[your-store].myshopify.com/apps/productreview/gwl-review-widget"
  width="100%"
  height="400"
  frameborder="0"
  loading="lazy"
></iframe>

2. Simple Star Rating — compact badge near product title or price:

https://[your-store].myshopify.com/apps/productreview/gwl-simple-rating?productId=[product-id]

3. Star Rating — full rating bar with count and review form near the bottom of the product page:

https://[your-store].myshopify.com/apps/productreview/gwl-star-rating?productId=[product-id]

Option B — Headless JSON APIs

Build custom UI by fetching raw review data:

GET https://[your-store].myshopify.com/apps/productreview/api/productreview?productId=[product-id]&page=1&limit=10&sort=highest

Supported query parameters:

page — page number (default: 1)
limit — reviews per page (default: 10)
sort — newest, oldest, highest, or lowest

You can also submit new reviews directly to the headless POST API:

POST https://[your-store].myshopify.com/apps/productreview/gwl-api/create-review

JSON Body Example: (The images array accepts both base64 strings and direct public image URLs)

{
              "productId": "123456789",
              "rating": 5,
              "author": "Jane Doe",
              "email": "jane@example.com",
              "title": "Amazing product!",
              "content": "Excellent quality, highly recommend.",
              "images": [
                "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA...",
                "https://example.com/image.jpg"
              ] 
            }

Metafields (Summary Ratings)

The app syncs aggregated data to Shopify product metafields queryable via Storefront API:

gwl-reviewinsights.rating — average star rating
gwl-reviewinsights.count — total review count

query ProductRating($id: ID!) {
  product(id: $id) {
    title
    rating: metafield(namespace: "gwl-reviewinsights", key: "rating") {
      value
    }
    ratingCount: metafield(namespace: "gwl-reviewinsights", key: "count") {
      value
    }
  }
}

Integration Checklist

Open your Hydrogen storefront project.
Navigate to the Product Details Page component.
Paste the iframe snippet or integrate the JSON API.
Pass the correct productId dynamically from product data.
Save and deploy your storefront.

7. Need More Help?

Browse the FAQ for quick answers to common questions, or open the in-app User Guide from your Shopify admin for the full interactive documentation with tabs and code examples.