The Subscription Milestone rule rewards a customer once a subscription reaches a set number of successful payments, for example after their 6th monthly delivery.
How to add the rule
From your Shopify admin, open the Mage Loyalty app and click Loyalty.
In the Earning Points section, click Add Earning Rule and choose Subscription Milestone.
Fill in the settings below and click Save.
Settings
Setting | What it does |
Earning rule name | The name customers see in Ways to Earn, for example "6 month subscriber reward". |
Amount to award | What the customer receives when they reach the milestone. VIP tier multipliers and bonus campaigns apply on top. |
Milestone | Choose When a subscription starts to reward the customer's first subscription order. Choose After a number of renewals to reward them once their subscription has renewed that many times. Renewals are the orders after the first one. |
Earning limit | Tick Limit how often each customer can earn this reward to reward a customer only once across all their subscriptions. Choose Once only, or Once every and a number of days. Leave it unticked to reward every subscription. |
Approval time | Days to hold the reward as pending before it can be spent. Leave at 0 for instant. |
Custom description | Under Advanced settings. Replaces the wording customers see under the rule. Use |
Hide on storefront | Under Advanced settings. Tick it to keep the rule out of your loyalty widget, sidebar and loyalty pages. The rule still awards. |
How it works
Every successful payment on a subscription adds one to its count. When the subscription reaches your milestone, the reward is given.
Each rule rewards a subscription once. Later payments on the same subscription do not award it again.
Each subscription is counted separately. A customer with two subscriptions can reach the milestone on both, unless you set an earning limit.
If a customer cancels and later subscribes again, the new subscription starts from zero and can earn the reward again, unless you set an earning limit.
If a customer cancels before reaching the milestone, nothing is awarded.
With Loop, Skio and Stay AI, a subscription that had already reached the milestone before you switched the rule on does not earn it. The reward is given when the milestone is reached, not afterwards.
Running several milestone rules
You can run several Subscription Milestone rules at once, each on its own milestone. For example, one rule for when a subscription starts and another after 5 renewals. A subscription can earn each of them once.
Two active rules cannot use the same milestone. If another active rule already uses it, you see an error naming that rule when you save, or when you enable the rule from the list on the Loyalty page. Edit the other rule, choose a different milestone, or leave one of the two disabled.
Examples
Goal | Milestone | Result |
Reward customers for subscribing | When a subscription starts | Rewarded on their first subscription order |
Reward customers who stay 6 months | After 5 renewals | Rewarded after the 6th monthly payment, held for the approval time if you set one |
Welcome bonus, once per customer | When a subscription starts, with earning limit Once only | Rewarded on their first subscription only, even if they start more later |