Skip to main content

Reviews.io Reviews

Reward customers for leaving reviews via Reviews.io using Shopify Flow.

Written by Kris James

Prerequisites

  • A Starter plan or higher on Mage Loyalty

  • Reviews.io installed on your Shopify store

  • Access to Shopify Flow (available on all Shopify plans)

Step 1: Create the Earning Rule

  1. In your Shopify admin, open the Mage Loyalty app

  2. Navigate to Loyalty Program > Earning Rules

  3. Click Leave a Review

  4. Configure the rule:

    • Earning rule name. Give the rule a name (e.g. "Leave a Review")

    • Review app. Select Reviews.io from the dropdown

    • Points. Enter the number of points to award per review (e.g. 100)

  5. (Optional) Set a frequency limit to prevent abuse. For example, you can limit customers to earning points for 1 review every 7 days

  6. Make sure the rule is enabled using the status toggle in the sidebar

  7. Click Save

Step 2: Set Up the Shopify Flows

Reviews.io exposes two separate triggers in Shopify Flow:

  • New Positive REVIEWS.io Company Review. Fires when a customer leaves a positive review of your store as a whole.

  • New Positive REVIEWS.io Product Review. Fires when a customer leaves a positive review of a specific product.

To reward customers for either type of review, you'll need to create one Shopify Flow per trigger. Both flows use the same Mage Loyalty action and the same field mappings, so the setup steps are identical.

Flow A: Company Reviews

  1. In your Shopify admin, go to Settings > Flow (or search for "Flow" in the admin search bar)

  2. Click Create workflow

  3. Click Select a trigger

  4. Search for REVIEWS.io and select New Positive REVIEWS.io Company Review

  5. Click the + button to add an action

  6. Search for Mage Loyalty and select the Add Points for Review action

  7. Configure the action fields (see the Field Mapping table below)

  8. Give the workflow a name like "Reviews.io Company Review - Award Points" and click Turn on workflow in the top right

Flow B: Product Reviews

Repeat the steps above, but this time select the New Positive REVIEWS.io Product Review trigger. Name the workflow something like "Reviews.io Product Review - Award Points" so you can tell the two flows apart.


Field Mapping

In the Add Points for Review action, fill in the fields as follows. The same mapping works for both the Company Review and Product Review flows.

Field

What to enter

Customer Email

Click Add variable and pick reviewerEmail, or paste {{reviewerEmail}}.

Internal Note

Free text to help you identify the source. We recommend "Reviews.io Company Review" or "Reviews.io Product Review" depending on the flow.

Image Count

Leave blank. Reviews.io does not currently expose this in Shopify Flow, and the Reviews.io earning rule doesn't support photo-specific point amounts.

Video Count

Leave blank. Same reason as above.

Rating

Click Add variable and pick reviewerRating, or paste {{reviewerRating}}.

Sentiment

Enter positive. Both triggers only fire for positive reviews, so this value can be hard-coded.


Step 3: Test the Integration

  1. Submit a test review on your store using Reviews.io (both a company review and a product review if you've set up both flows)

  2. Check that the Shopify Flow ran successfully:

    • Go to Settings > Flow and click on your workflow

    • Check the Run history tab for recent executions

  3. Verify the customer received points:

    • In the Mage Loyalty app, navigate to Customers

    • Find the customer who left the review and confirm their points balance increased


Frequently Asked Questions

Why does Reviews.io have two triggers?
Reviews.io distinguishes between reviews left about your store as a whole (Company) and reviews left about a specific product (Product). They are separate events in Shopify Flow, so you need one flow per trigger if you want to reward both.

What if the customer isn't enrolled in the loyalty program?
Points are only awarded to customers who are already part of your loyalty program. If the customer hasn't enrolled yet, the review will be recorded but no points will be given.

Can I use frequency limits?
Yes. When configuring the earning rule, enable the frequency limit option. For example, you can limit customers to earning points for 1 review every 7 days. This prevents abuse while still rewarding genuine reviewers.

Does this work with VIP tier multipliers?
Yes. If your loyalty program has VIP tiers with point multipliers enabled, the multiplier will automatically apply to review points.

Can I set an approval delay?
If your earning rule has an approval time configured, points will be held in a pending state until the approval period has passed. This gives you time to moderate reviews before points are awarded.


Troubleshooting

Points aren't being awarded

  • Verify the Shopify Flow is turned on and check the run history for errors

  • Confirm the earning rule is enabled in Mage Loyalty and the Review app is set to Reviews.io

  • Make sure the Customer Email field in the Flow action is mapped to reviewerEmail, not left blank or set to a different variable

  • Check that the customer is enrolled in your loyalty program

Flow shows an error

  • Ensure the Customer Email field is correctly mapped from the Reviews.io trigger

  • Verify your Mage Loyalty app is installed and your subscription is active

Only one of the two flows is firing

  • Confirm both flows are turned on in Settings > Flow

  • Make sure you selected the correct trigger in each flow (one Company, one Product)

  • Submit one company review and one product review on the storefront to verify each trigger independently

Need help?
Use our live chat inside the Mage Loyalty app or email us at [email protected].

Did this answer your question?