Introduction
Connect CWILL Loyalty to Shopify Flow to react to loyalty moments, and to give points or change VIP tiers from anything that happens in your store or other apps.
Walkthrough Video
How CWILL Loyalty Works with Shopify Flow
A workflow has three parts. See Shopify's guide to Flow for more.
Trigger: the event that starts the workflow.
Condition (optional): rules that decide whether it continues.
Action: what happens as a result.
CWILL Loyalty provides both:
Triggers: start a workflow when something happens in your loyalty program.
Actions: give points or change a VIP tier from any trigger.
Build a workflow
Open Shopify Flow and click Create workflow.
Click Select a trigger and pick one from CWILL Loyalty or any other app.
Click Add a condition or action and set up the next step.
Click Turn on workflow.
CWILL Loyalty Triggers
Every CWILL Loyalty trigger includes customer (Customer), so you can check the customer's tags, order count or total spent in a condition, and use any customer action, like adding a tag or sending a Shopify Email. Insert trigger data anywhere with Add variable, for example {{pointsAdded}}.
Each trigger below lists its other properties.
Dates are text in your store's time zone. You can show them in a message but can't compare them in a condition.
Reward redemption and expiry dates include the time, like
2026-12-13T15:42:00+08:00. A reward expires at that moment, not at the end of the day.Points expiry and birthday dates are dates only, like
2026-10-13.
To format a date, add a filter, like {{rewardExpiryDate | date: "%b %d, %H:%M"}} for Dec 13, 15:42.
Points
Points earned: a customer earns points.
Property | Type | Description |
| Number | Points earned. |
| Text | How they were earned, like Place an order, Sign up reward, Leave a review or Flow reward. |
| Text | Activity name shown to customers. |
Points expiring - Warning / Points expiring - Last chance: the first / last reminder before points expire.
Property | Type | Description |
| Number | Points about to expire. |
| Text (date) | When the points expire, like 2026-10-13. |
| Number | Days left. |
Rewards
Reward redeemed: a customer redeems points for a reward.
Property | Type | Description |
| Text | Discount code. |
| Text | Reward name. |
| Text | Reward details and conditions. |
| Text (date and time) | When the reward was redeemed, like 2026-10-13T15:42:00+08:00. |
| Number | Points spent. |
| Text (date and time) | When the reward expires, like 2026-12-13T15:42:00+08:00. |
Reward expiring - Warning / Reward expiring - Last chance: the first / last reminder before a reward expires.
Property | Type | Description |
| Text | Discount code. |
| Text | Reward name. |
| Text (date and time) | When the reward expires, like 2026-12-13T15:42:00+08:00. |
| Number | Days left. |
Referrals
In both referral triggers, customer is the person who shared the referral link.
Referral share: a referred friend claims their reward. It doesn't wait for the referral to be completed.
Property | Type | Description |
| Text | Referrer's name. |
| Text | Referrer's email. |
| Text | Friend's reward name. |
| Text | Friend's discount code. |
Referral completed: a referral is completed and the referrer gets a reward.
Property | Type | Description |
| Text | Friend's email. |
| Text | Referrer's reward name. |
| Text | Referrer's discount code. |
| Number | Referrer's points. |
| Number | Referrer's total completed referrals, including this one. |
Birthdays
Birthday reward available: a customer can claim their birthday reward.
Property | Type | Description |
| Number | Birthday points to claim. |
| Text (date) | Birthday, like 1970-10-13. The year is 1970 if the customer didn't set one. |
Customer's birthday: a member's birthday, whether or not they can claim a reward. Sends only customer.
VIP tiers
Customer moved up a tier / Customer moved down a tier: a customer moves to a higher / lower VIP tier.
Property | Type | Description |
| Text | Tier after the change. |
| Text | Tier before the change. Empty if there was none. |
📝 Good to know
Points earned runs a lot. Every run counts toward your Flow usage. Add a condition, like
pointsAddedis greater than 100 orearnActionis Place an order.Reminders run once a day. Expiry reminders and Birthday reward available are checked daily in your store's time zone. Each customer gets each reminder once. Changing the reminder days doesn't resend past reminders.
Set expiry reminder days in Integrations > Event settings > Expiry reminder timing. The same days apply to Klaviyo, Omnisend and webhooks.
No past events. Triggers only run for events after the workflow is turned on.
CWILL Loyalty Actions
Actions change a customer's points or VIP tier, after any trigger.
Action | What it does |
Complete an earning activity | Completes a Ways to Earn activity. Points and limits follow the activity. |
Adjust points by variable | Adds or deducts a number calculated in Flow, like 2× the order total. |
Adjust points by fixed amount | Gives the same points every run. |
Assign an exclusive VIP tier | Moves a customer into a tier and keeps them there. |
Remove an exclusive VIP tier | Returns the customer to the tier they've earned. |
Run limit
If CWILL Loyalty actions run 30 times in 10 minutes, the actions that give points or tiers pause. This stops a looping workflow from giving away points. See Setups to Avoid.
Paused:
Adjust points by variable, when it adds points
Adjust points by fixed amount
Complete an earning activity
Assign an exclusive VIP tier
Still run:
Adjust points by variable, when it deducts points
Remove an exclusive VIP tier
Only Flow actions count. Points from orders, reviews, and other ways to earn don't count toward the limit.
Choose the customer
Most actions have two customer fields, Customer and Customer email. Adjust points by fixed amount only has Customer, so use it with a trigger that includes a customer.
Trigger includes a customer (like Order created or any CWILL Loyalty trigger): Flow fills in Customer. Leave Customer email empty.
Trigger only has an email (like many review or survey apps): the panel shows No customer found. Under Customer email, click Add variable and pick the email variable, like
{{reviewerEmail}}.
The customer fields aren't repeated in the tables below.
1. Complete an earning activity
Completes an activity under the same rules as any other customer: it must be turned on and active, the customer must be eligible, and limits apply. Points history shows the activity name.
Fields
Field | Required | Description |
Activity ID | Yes | See Find an Activity ID or Tier ID. |
Returns
Property | Type | Description |
| Text | SUCCESS, SKIPPED or FAILED. |
| Text | Activity that ran. |
| Text | Activity type. |
| Number | Points given. 0 if none. |
| Text | Reward given. Empty if none. |
| Number | Balance after the run. |
| Text | Points transaction. Empty if no points. |
| Text | Why it was skipped. |
| Text | Why it failed. |
⚠️ Keep in mind
Place an order isn't supported.
2. Adjust points by variable
Adds or deducts a number calculated in Flow.
Fields
Field | Required | Description |
Points to adjust | Yes | A number, or an expression built with Add variable. For example, 2 points per $1 spent:
Negative numbers deduct points. Decimals round to the nearest whole number (0.5 rounds up). Add |
Reason | Yes | Shown in the customer's points history as Shopify Flow dynamic points, like Double points weekend. |
Returns
Property | Type | Description |
| Text | SUCCESS or FAILED. |
| Number | Points changed. Negative if deducted. |
| Number | Balance after the run. |
| Text | Points transaction. |
| Text | The reason you entered. |
| Text | Why it failed. |
⚠️ Keep in mind
No earning limits. It runs every time the workflow runs, up to the Run limit above. Use your trigger and conditions to control when.
Balances can go below zero if you deduct more than the customer has.
A result of 0 succeeds without changing points.
Adding points sends the points earned email and updates the VIP tier.
3. Adjust points by fixed amount
Gives the same points every run. This is the former Add Points action; existing workflows keep running unchanged.
Fields
Field | Required | Description |
How many points to earn | Yes | Points to give. |
Instructions for earning points | Yes | Shown in the customer's points history. |
⚠️ Keep in mind
No earning limits. It runs every time the workflow runs, up to the Run limit above. Use your trigger and conditions to control when.
4. Assign an exclusive VIP tier
Moves the customer into a tier. They stay there and no longer move up or down automatically. If they're already in that tier, they're kept there.
Fields
Field | Required | Description |
Tier ID | Yes | Any tier. See Find an Activity ID or Tier ID. |
Issue entry reward | No | Checkbox, off by default. Gives the tier's entry rewards. Only applies when the customer moves up, and follows your tier skipping and re-entry settings. |
Returns
Property | Type | Description |
| Text | SUCCESS or FAILED. |
| Text | Tier before the change. |
| Text | Tier after the change. |
| Text | Entry reward given. Empty if none. |
| Date and time | When the tier changed. |
| Text | Why it failed. |
5. Remove an exclusive VIP tier
Removes the assigned tier and returns the customer to the tier they've earned. Skipped if they have no assigned tier. No fields besides the customer.
Returns
Property | Type | Description |
| Text | SUCCESS, SKIPPED or FAILED. |
| Text | Tier removed. |
| Text | Tier after removal. |
| Date and time | When the tier changed. |
| Text | Why it was skipped. |
| Text | Why it failed. |
Find an Activity ID or Tier ID
In CWILL Loyalty, open the activity under Program > Points > Earn points, or the tier under Program > VIP > VIP tier.
In Summary on the right, click the copy icon next to the ID.
Paste it into the action in Flow.
Place an order activities have no ID because they can't be used in Flow.
Use what an action returns
Later steps can use an action's Returns with Add variable. For example, if status is FAILED, send a Slack message with failureReason.
Core Scenarios and Examples
Scenario 1: React to loyalty moments
CWILL Loyalty trigger + any action. Tag customers, add them to a segment, notify your team, or send data to another app.
Example: tag customers whose points are about to expire
Trigger: CWILL Loyalty > Points expiring - Warning
Condition: Expiring points is greater than 500
Action: Shopify > Add customer tags, tag
points-expiring
Then target the points-expiring segment with an ad or a Shopify Email campaign.
More ideas
Notify your team about top customers: Customer moved up a tier → condition: new tier is your top tier → Send internal email.
Send referrals to your CRM: Referral completed → Send HTTP request.
Follow up on unused rewards: Reward expiring - Last chance → Add customer tags.
Scenario 2: Reward actions CWILL Loyalty can't see
Any trigger + Complete an earning activity. Reward a review in another app, a survey, a quiz, or joining a segment. Create the activity in CWILL Loyalty first, then copy its ID into Flow.
Example: give points for 4+ star Loox reviews
In CWILL Loyalty, go to Program > Points > Earn points, open Leave a review, and select Shopify Flow as the review app.
Copy the Activity ID from Summary.
Build the workflow:
Trigger: Loox - Product Reviews App > New review
Condition (optional): Rating is 4 or higher
Action: CWILL Loyalty > Complete an earning activity. Paste the Activity ID, and set Customer email to the reviewer's email.
Click Turn on workflow.
Points and limits follow your Leave a review settings. No photo bonus for reviews from Flow.
Example: reward a product quiz with a Custom Action
In CWILL Loyalty, go to Program > Points > Earn points, click Add ways to earn, and choose Custom action. Set the name, points, completion limit and icon, like Complete a product quiz, 150 points, once per customer. Leave the action button off if Flow is the only way to complete it.
Save, then copy the Activity ID from Summary.
Build the workflow:
Trigger: your quiz app's Quiz completed, or any other event
Condition (optional): keep only the events you want to reward
Action: CWILL Loyalty > Complete an earning activity. Paste the Activity ID. Set Customer email if the trigger has no customer.
Customers see the activity in your loyalty program with its own name and icon, and in points history. Flow only decides when it's completed.
More ideas
Reward a survey: survey submitted → Complete an earning activity with a custom activity. Set Customer email to the survey's email.
Reward joining a segment once: Customer joined segment → Complete an earning activity limited to once per customer. Later joins are skipped.
Reward subscription renewals: renewal trigger → Complete an earning activity with your renewal activity.
Scenario 3: Give points calculated in Flow
Any trigger + Adjust points by variable. When points depend on trigger data, like the order total, items or tags. For the same points every time, use Adjust points by fixed amount.
Example: double points for VIP-tagged customers
Trigger: Shopify > Order paid
Condition: Customer tags include VIP
Action: CWILL Loyalty > Adjust points by variable
Points to adjust:
{{order.currentTotalPriceSet.shopMoney.amount | times: 2}}Reason: VIP double points
More ideas
Extra points for a collection: Order paid → condition: order includes the collection → Adjust points by variable, item count × 50.
Take points back on refund: refund trigger → Adjust points by variable with a negative number.
Points back on big redemptions: Reward redeemed → condition: Points spent is at least 1000 → Adjust points by fixed amount, 50.
Scenario 4: Manage VIP tiers from Flow
Any trigger + Assign / Remove an exclusive VIP tier. Put customers in a tier based on something CWILL Loyalty doesn't track, like a tag, segment or partnership.
Example: put partner-tagged customers in Gold
Workflow 1, assign the tier:
Trigger: Shopify > Customer tags added
Condition: Tags include
partnerAction: CWILL Loyalty > Assign an exclusive VIP tier. Tier ID: your Gold tier ID, like 5009. Leave Issue entry reward off.
Workflow 2, remove it:
Trigger: Shopify > Customer tags removed
Condition: Tags include
partnerAction: CWILL Loyalty > Remove an exclusive VIP tier
Scenario 5: Reward referral milestones
Referral completed + one branch per milestone. Use referralCompletionCount so each bonus is given once, on the referral that reaches it.
Example: bonuses for the 2nd, 3rd and 4th referral
Trigger: CWILL Loyalty > Referral completed
Condition branches, each followed by CWILL Loyalty > Adjust points by fixed amount:
Referral completion count is equal to 4 → 500 points, 4th successful referral bonus
Otherwise, equal to 3 → 300 points, 3rd successful referral bonus
Otherwise, equal to 2 → 200 points, 2nd successful referral bonus
Use is equal to, not greater than or equal to, or the 2nd-referral bonus repeats on every later referral. Turn on Referral completed in Integrations > Event settings first.
Setups to Avoid
⚠️ Points earned → Adjust points by variable or fixed amount
The new points start Points earned again, in an endless loop. Add the condition: Earn action is not Flow reward.
⚠️ Complete an earning activity with Place an order, Sign up, or CWILL Product Reviews / Judge.me review activities
CWILL Loyalty already gives these points, so customers get them twice.
⚠️ Customer moved up a tier → Assign an exclusive VIP tier to a higher tier
Each change starts the trigger again and can push customers to the top tier.
Troubleshooting
Errors when you save a workflow
"Add the customer's email, or use a trigger that includes a customer."
Set Customer email, or use a trigger with a customer.
"This isn't a customer. Pick a customer variable, like {{customer.id}}."
Pick a customer variable for Customer.
"We can't find this activity…" / "We can't find this tier…"
Copy the ID again from the activity's or tier's Summary.
"Place an order activities can't be used here."
Pick another activity, or use Adjust points by variable.
A run didn't give points or change a tier
Check Recent runs in the workflow.
Customer not found (failed)
The email is empty, matches no customer or several, or the customer isn't a member yet. Adjust points by variable also works for non-members.
No change made. Check the settings in CWILL Loyalty. (skipped)
For example, the customer isn't eligible or hit the limit, the activity is off or inactive, or there's no assigned tier to remove.
Couldn't complete this step. Check the settings in CWILL Loyalty. (failed)
For example, the activity calculates points from order data, Points to adjust isn't a number, or the activity or tier was deleted or turned off.
Still stuck? Contact us through live chat with the workflow name and run time.












