Prerequisites
A Starter plan or higher on Mage Loyalty
Loox installed on your Shopify store
The Convert plan or above on Loox.
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 Loox from the dropdown
Points. Enter the number of points to award per review (e.g. 100)
(Optional) Set a Photo review amount to award a different number of points when a review includes a photo. See the Photo Review Points section below for how this works with Loox
(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 Flow
Once the earning rule is saved, you need to create a Shopify Flow that awards the points when a customer submits a review in Loox.
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 Loox and select the New review trigger
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 "Loox Review - Award Points" and click Turn on workflow in the top right
Field Mapping
In the Add Points for Review action, fill in the fields as follows. To insert a value from Loox, click Add variable and pick the attribute by name from the Loox trigger.
Field | What to enter |
Customer Email | Required. Click Add variable and pick the Loox Email attribute (the reviewer's email address). Points are matched to the loyalty customer by this email, so the flow cannot award anything without it. |
Internal Note | Free text to help you identify the source. We recommend "Loox review". |
Image Count | Click Add variable and pick the Loox Photo URL attribute. |
Rating | Click Add variable and pick the Loox Rating attribute (the star rating given by the reviewer). |
Frequently Asked Questions
Why do I need the Convert plan on Loox?
Shopify Flow triggers are a paid Loox feature, available on the Convert plan and above.
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 or store credit 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
The Loox trigger doesn't appear in Shopify Flow
Check your Loox plan. The New review trigger is only available on the Loox Convert plan and above
Confirm Loox is installed on the store you are building the workflow in
Points / store credit 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 Loox
Make sure the Customer Email field in the Flow action is mapped to the Loox Email attribute, not left blank or set to a different variable
Check that the customer is enrolled in your loyalty program
Photo reviews are earning the base amount
Confirm the Image Count field in the Flow action is mapped to the Loox Photo URL attribute. If it is blank, every review earns the base amount
Confirm a Photo review amount is saved on the earning rule. If it is empty, photo reviews fall back to the base amount
Check the review actually has a photo attached in Loox
Flow shows an error
Ensure the Customer Email field is correctly mapped from the Loox trigger
Verify your Mage Loyalty app is installed and your subscription is active
