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
In your Shopify admin, open the Mage Loyalty app
Navigate to Loyalty Program > Earning Rules
Click Leave a Review
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)
(Optional) Set a frequency limit to prevent abuse. For example, you can limit customers to earning points for 1 review every 7 days
Make sure the rule is enabled using the status toggle in the sidebar
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
In your Shopify admin, go to Settings > Flow (or search for "Flow" in the admin search bar)
Click Create workflow
Click Select a trigger
Search for REVIEWS.io and select New Positive REVIEWS.io Company Review
Click the + button to add an action
Search for Mage Loyalty and select the Add Points for Review action
Configure the action fields (see the Field Mapping table below)
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 |
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 |
Sentiment | Enter |
Step 3: Test the Integration
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)
Check that the Shopify Flow ran successfully:
Go to Settings > Flow and click on your workflow
Check the Run history tab for recent executions
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 variableCheck 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].
