Achievements overview.
What achievements are, what a loyalty day is, the full milestone catalog, and which plans include the feature.
Achievements recognize the customers who keep coming back. A business turns the program on once, and from then on the platform tracks each member's real loyalty at that business: the days they earned something, the weeks they returned in a row, and their firsts along the way. Members watch their own progress in the wallet, and the business can attach an optional reward to any milestone.
Achievements measure recorded loyalty activity, never vanity actions. There are no points for follows, reviews, or profile fields, no leaderboard, and no member-to-member comparison. Each business only ever sees its own members' progress, and a member's achievements at one business are invisible to every other business on the installation.
What a loyalty day is
A loyalty day is one calendar date, in the business's own timezone, on which a member earned something real at that business: points from a purchase, a stamp, a redeemed reward or voucher, or a prepaid pass action. However much happens on one date, it counts as one loyalty day.
Example: a member buys a coffee at 9:00 (points), redeems a voucher at lunch, and collects a stamp at 17:30, all on March 4. That is one loyalty day. When she returns on March 6 for a single stamp, that is her second loyalty day.
Not every ledger row qualifies. Bonuses, transfers between members, refunds, corrections, expiry entries, and rewards delivered by the achievements program itself never create a loyalty day. Only actions a customer took at the business count. Achievements also only track registered members; a guest who has not linked an email yet starts counting once they register.
Weekly runs
A weekly run counts how many weeks in a row a member earned at least one loyalty day. Weeks follow the business's timezone and its chosen week start (Sunday or Monday, set once during setup).
The current week is never held against a member. A run only reads as broken after a full week passes with no loyalty day, so a member who earned last week and has not earned yet this week still holds their run. The wallet shows a calm nudge instead: "Earn with us this week to keep your run."
Changing the week start later never breaks an active run. Past weeks stay as counted, and the new rule applies from that point forward. See Partner setup for the details.
The milestone catalog
Achievements come from a curated, versioned catalog. The names, meanings, and thresholds are fixed, so a milestone means the same thing at every business, and a business chooses which entries to switch on. There are 15 entries in five groups:
| Achievement | Group | How a member earns it | Availability |
|---|---|---|---|
| First step | Loyalty | Earn your first loyalty day. | Always available |
| 5 loyalty days | Loyalty | Earn loyalty days on 5 different dates. | Always available |
| 10 loyalty days | Loyalty | Earn loyalty days on 10 different dates. | Always available |
| 25 loyalty days | Loyalty | Earn loyalty days on 25 different dates. | Always available |
| 50 loyalty days | Loyalty | Earn loyalty days on 50 different dates. | Always available |
| 100 loyalty days | Loyalty | Earn loyalty days on 100 different dates. | Always available |
| 4-week regular | Consistency | Earn a loyalty day in 4 weeks in a row. | Always available |
| 8-week regular | Consistency | Earn a loyalty day in 8 weeks in a row. | Always available |
| 12-week regular | Consistency | Earn a loyalty day in 12 weeks in a row. | Always available |
| Loyalty explorer | Exploration | Use 2 different loyalty options, such as points and stamps. | Needs a second active loyalty option |
| Loyalty explorer plus | Exploration | Use 3 different loyalty options. | Needs a third active loyalty option |
| First reward enjoyed | Exploration | Redeem your first reward. | Needs an active points card, stamp card, or voucher |
| First pass used | Exploration | Use a prepaid pass for the first time. | Needs an active prepaid pass |
| First successful referral | Advocacy | Invite a friend who then makes their first purchase. | Needs the referral program switched on |
| One year together | Anniversary | Earn a loyalty day a full year after your first. | Always available |
An entry whose condition a business does not meet shows as Not available yet on the setup page, with a plain explanation and a link to fix it, for example by adding a second loyalty product. Custom achievement names, icons, or formulas are not part of the product; the curated catalog is the point.
Which plans include it
Achievements is a plan feature, controlled by the has_achievements flag. On the shipped tiers it is off on Bronze and on for Silver, Gold, and Platinum. Operators change any tier in the admin Plans editor or with PLAN_<TIER>_HAS_ACHIEVEMENTS in .env, and can grant or revoke the feature for a single partner on the partner's Permissions tab.
A partner whose plan lacks the feature sees a calm upgrade page in place of the setup screen. When no active plan includes achievements at all, the feature stays hidden everywhere.
If the feature is later removed from a partner, nothing is deleted: members keep every achievement they earned, and rewards already on their way still arrive. New progress stops counting until the feature returns.
What members see
Members follow their progress in their own wallet: a compact summary card on My Cards, a full achievements page per business, a brief celebration the moment a milestone lands, and one notification per earning moment. Email about achievements follows the member's own loyalty-updates preference. See Member experience.
Related topics
- Partner setup: The setup wizard, the calendar, and the history import
- Rewards and limits: Attaching rewards, caps, windows, and delivery
- Member experience: What members see in the wallet
- Achievements troubleshooting: Answers for partners and operators