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. |
Approval time | Days to hold the reward as pending. Leave at 0 for instant. A window of 30 days or more gives time for refunds and cancellations. |
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.
If a customer cancels and later subscribes again, the new subscription starts from zero and can earn the reward again.
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 |