Enabling Points Expiry
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Loyalty.
Scroll to the Points Expiry section at the bottom of the page.
Check the box labelled Enable points expiry.
Select an expiry mode: "Time after points are acquired" or "Customer's last purchase date".
Select an expiry reminder. If email templates or integrations such as Klaviyo, Omnisend, Postscript or Attentive are enabled, you can optionally send expiry reminders. If none of these are enabled, no reminders are sent.
Enter a number in the Points expire after field.
Click Save.
Note
Setting the days field to 0 means points never expire, the same as leaving expiry disabled. Always enter a value greater than 0 when enabling this setting.
Choose an Expiry Mode
After enabling points expiry, you can choose how the expiry clock works. This controls what the expiry countdown is based on.
Time After Points Are Acquired (Default)
Each batch of points expires independently, based on when they were earned. If a customer earns points on January 1st and again on February 1st with a 90-day expiry, the January points expire on April 1st and the February points expire on May 1st.
This is the default mode and works well for most stores.
Customer's Last Purchase Date
Every purchase resets the expiry clock for all of the customer's active points, not just the points earned from that order. As long as a customer keeps purchasing within the expiry window, their points never expire.
The one exception is points granted through a Points Drop. Those keep the expiry date set on the drop itself and are never extended by purchases.
For example, a customer has 500 points set to expire on March 27th. They make a purchase on March 25th with a 90-day expiry setting. All 500 points now expire on June 23rd. If they purchase again before June 23rd, the expiry moves forward again.
This mode rewards purchase frequency and recurring orders without forcing customers to redeem their points within a fixed window.
Which mode should I choose?
Mode | Best for | How it works |
Time after points are acquired | Most stores. Simple, predictable expiry. | Each earning event has its own independent expiry date. |
Customer's last purchase date | Stores that prioritise repeat purchases and want to reward buying frequency. | Every purchase extends the life of all active points. |
Note
You can switch between modes at any time. When switching to "Customer's last purchase date", existing points keep their current expiry dates until the customer makes their next purchase, which will reset all of them.
Important: changing the expiry window later
The expiry date is fixed on each batch of points at the moment they are earned, using the number of days set at that time. If you later change the "Points expire after" number, the new window applies only to points earned after the change. Existing points keep their original expiry dates and will continue to expire on those dates. If you need existing points moved to the new window, contact Mage support.
Choosing the Right Expiry Window
The window you set should reflect your customers' natural purchase cycle. Too short and you risk frustrating loyal customers. Too long and the urgency effect is lost.
Store Type | Suggested Window | Reasoning |
Consumables / replenishment(beauty, supplements, food) | 180 to 365 days | Customers buy regularly: 6 to 12 months is fair and still creates urgency. |
Fashion / apparel | 365 days | Seasonal buying patterns mean customers may only shop 2 to 4 times a year. |
General ecommerce | 365 days | Safe default for most stores. One year gives customers ample time. |
High-frequency / subscription | 90 to 180 days | Customers buy often: a shorter window is reasonable and drives faster redemption. |
Not recommended | Under 90 days | Very short windows frustrate customers and generate negative sentiment. |
Points Expiry Email Notifications
Mage Loyalty automatically sends customers a Points Expiring email before their balance is due to expire using the time window set. This gives them time to return and redeem before losing their points.
The notification is sent automatically, no manual action needed from you.
You can customise the email content in Email Templates in the Mage Loyalty app. The send timing (how many days before expiry the reminder goes out) is set in the Points Expiry section of the Loyalty page.
Optionally you can fire a Klaviyo, Omnisend, Postscript or Attentive event.
How Points Expiry Works
How the expiry clock works depends on the mode you have selected:
Time after points are acquired: Points expire per batch. Each group of points earned starts its own expiry clock from the date they were awarded.
Customer's last purchase date: All active points share the same expiry date. Every purchase resets the clock for all points, including points earned from non-purchase actions like signups, birthdays, and social follows. Points Drop points are the exception and keep the drop's own expiry date.
In both modes:
Points earned before expiry was enabled are grandfathered in and will never expire. Only points earned after the setting is turned on will have an expiry date.
Expired points are permanently removed from a customer's balance and cannot be reinstated automatically.
Customers can view their points balance and expiry dates in the loyalty sidebar.
Important
If you are enabling expiry for the first time on a store with existing customers, their existing points are grandfathered and will not expire. Only points earned after the setting goes live carry an expiry date. It is still worth announcing the change to your members so they understand how their future points will behave.
Common Mistakes to Avoid
Common Mistake
Setting an expiry window under 90 days: Very short windows erode trust. Customers who earn points on a purchase and find them expired before their next visit are unlikely to re-engage with your program.
Common Mistake
Enabling expiry without notifying existing customers: Customers will not lose their existing points, but new points will start carrying expiry dates. Communicate the change before it takes effect so nobody is surprised later.
Common Mistake
Manually reinstating expired points frequently: If you regularly add back expired points as goodwill gestures, your expiry window is probably too short. Adjust the setting rather than managing exceptions.
Troubleshooting
Customers are not receiving the expiry reminder email
Check that the Points Expiring email template is enabled in Email Templates.
Confirm the customer's email address is valid and their account is active.
Ensure in your Klaviyo, Omnisend, Postscript or Attentive integration page that you have enabled the points expiry event.
A customer's points expired but they believe they should not have
Check the customer's points history in the Customers section to see when points were earned and when they expired.
If appropriate, add points manually as a goodwill gesture via Customers > Manual Points Adjustment.
I want to disable points expiry
Go to Loyalty > Points Expiry, uncheck Enable points expiry, and click Save.
Points that have already expired are not reinstated. Only unexpired points are preserved going forward.
Disabling expiry pauses the clock rather than clearing it. Each batch of points keeps its expiry date, but nothing expires while the setting is off. If you re-enable expiry later, any points whose date has already passed will expire on the next nightly run, so review your customers' balances before turning it back on.
Still need help or can't find the answers you're looking for? Reach out to the Mage Loyalty team through our live chat support.