Points and rewards: the parts, in plain words

33 parts and 16 phrases. Apps in this area include Smile.io, LoyaltyLion, Yotpo Loyalty, Rivo, BON Loyalty.

Pointsloyalty.pointsShowHow points are earned, stored, spent and expired.

Earning pointsloyalty.points.earnShowThe actions that add points to a customer's balance.

How to extend

EventMany side by sideevent.order.paid event.customer.created event.review.approvedA plugin that awards points for other actions listens to the matching store event and records each award as a points movement.

Part	Litestore today	How to extend
Points per amount spent`loyalty.points.earn.per_spend`Purchase points add one point per unit of store currency spent when an order is paid, once per order whichever way it was paid.	Core`modules/orders/paid-accrual.ts`	Event · many
Points for a referral`loyalty.points.earn.referral`Referral points go to a customer when a friend they referred places a first order that stays fully paid through the hold period.	Core`modules/creators/referrals/customer-referrals.ts`	Event · many
Points for signing up`loyalty.points.earn.signup`Sign-up points are a one-time award when a shopper creates an account.	Plugin	Event · many
Birthday points`loyalty.points.earn.birthday`Birthday points are awarded once a year on the date of birth the customer entered.	Plugin	Event · many
Points for a review`loyalty.points.earn.review`Review points are awarded when a review the customer wrote is published.	Plugin	Event · many
Points for following`loyalty.points.earn.social_follow`Follow points are awarded when a customer clicks through to follow the store on a social network.	Plugin	Event · many
Bonus points on products`loyalty.points.earn.product_bonus`Product bonus points add extra points when the order contains chosen products or collections.	Plugin	Event · many
Points multiplier`loyalty.points.earn.multiplier`A multiplier awards two or more times the usual purchase points for orders placed within a set date range.	Plugin	Event · many

Balance and historyloyalty.points.balanceShowThe points a customer holds and the record of every change to them.

How to extend

Core onlyPoints are a conserved value: every change happens in core, in the same transaction as the order or refund that causes it.

Part	Litestore today	How to extend
Points balance`loyalty.points.balance.balance`The points balance is a whole number stored on each customer record.	Core`prisma/schema.prisma`	Core only
Points history`loyalty.points.balance.movement_log`The points history records every change with the amount, the balance before and after, the reason and the order it belongs to.	Core`modules/promotions/loyalty/movement.ts`	Core only
Points taken back on refund`loyalty.points.balance.refund_reversal`A refund removes the purchase points earned on the refunded amount and returns any points the customer spent on the order.	Core`modules/orders/refund-reversal.ts`	Core only
Points taken back on cancel`loyalty.points.balance.cancel_reversal`Cancelling an order removes the points it earned and returns the points that were spent on it.	Core`modules/orders/cancel-order.ts`	Core only
Manual adjustment`loyalty.points.balance.manual_adjust`A manual adjustment lets staff add or remove points on one customer with a written reason.	Plugin	Core only

Spending pointsloyalty.points.redeemShowWhat points turn into, and at what rate.

How to extend

SlotMany side by sidestorefront.slot.cart.below_itemsA rewards plugin shows extra reward choices, such as a free product, below the cart items.

Part	Litestore today	How to extend
Points as a discount`loyalty.points.redeem.points_discount`A points discount takes money off the cart total, and the points leave the balance only when the payment succeeds.	Core`modules/checkout/cart-discounts.ts`	Slot · many
Redeem rate`loyalty.points.redeem.rate`The redeem rate sets how many points equal one unit of currency off, twenty by default, so a hundred points take five off.	Core`modules/promotions/loyalty/points-rates.ts`	Slot · many
Points or a code`loyalty.points.redeem.one_discount`The cart holds one discount at a time, so a points discount and a discount code cannot be used on the same order.	Core`modules/checkout/cart-discounts.ts`	Slot · many
Refund as points`loyalty.points.redeem.refund_as_points`A store-credit refund pays the refunded amount back as points at the redeem rate instead of money to the card.	Core`modules/orders/refunds/refund-requests.ts`	Slot · many
Points for a discount code`loyalty.points.redeem.reward_code`A reward code exchanges a fixed number of points for a one-time discount code the customer applies later.	Plugin	Slot · many
Free product reward`loyalty.points.redeem.free_product`A free product reward exchanges points for a chosen product added to the cart at no charge.	Plugin	Slot · many
Free shipping reward`loyalty.points.redeem.free_shipping`A free shipping reward exchanges points for no shipping charge on the next order.	Plugin	Slot · many

Points running outloyalty.points.expiryShowRules that remove unused points after a time.

How to extend

ProviderOne per storeloyalty programA full loyalty app with expiry and tiers replaces the built-in points program; one program runs per store.

Part	Litestore today	How to extend
Expiry after inactivity`loyalty.points.expiry.inactivity`Inactivity expiry removes a customer's points when they have not earned or spent any for a set number of months.	Plugin	Provider · one
Expiry on a fixed date`loyalty.points.expiry.fixed_date`Fixed-date expiry removes points older than a set age once a year on the same date for everyone.	Plugin	Provider · one
Expiry reminder`loyalty.points.expiry.reminder`An expiry reminder emails the customer a set number of days before their points are removed.	Plugin	Provider · one

Tiers by thresholdloyalty.tierShowLevels a customer reaches by spending or earning, each with its own benefits.

How to extend

ProviderOne per storeloyalty programTiers come with a full loyalty app that replaces the built-in points program.
EventMany side by sideevent.order.paid event.order.refundedA tier plugin recalculates a customer's level from their paid and refunded orders.

Part	Litestore today	How to extend
Tier threshold`loyalty.tier.threshold`A tier threshold is the amount spent or points earned, within a set period, that moves a customer into a tier.	Plugin	Provider · oneEvent · many
Tier benefit`loyalty.tier.benefit`A tier benefit is what members of a tier get, such as a higher earn rate, free shipping or early access to sales.	Plugin	Provider · oneEvent · many
Reward on reaching a tier`loyalty.tier.entry_reward`An entry reward is a one-time gift of points or a code when a customer moves up a tier.	Plugin	Provider · oneEvent · many
Keeping a tier`loyalty.tier.keep_rule`A keep rule sets how long a customer stays in a tier and what they must spend to avoid moving down.	Plugin	Provider · oneEvent · many

Where customers see itloyalty.displayShowThe pages, emails and staff screens that show points.

How to extend

SlotMany side by sideaccount.slot.home.mainA loyalty plugin renders its rewards list and earning rules in the customer's account.
Assistant toolgetCustomerSummaryThe assistant reads a customer's points balance with their order count and spend.

Part	Litestore today	How to extend
Balance in the account`loyalty.display.account_balance`The account header shows the customer's current points balance on every account page.	Core`modules/customers/storefront/dashboard/dashboard-intro.tsx`	Slot · manyAssistant tool
Points shown as money`loyalty.display.points_value`The discounts page in the account shows the balance as the amount of money it takes off an order.	Core`modules/customers/storefront/dashboard/dashboard-discounts-view.tsx`	Slot · manyAssistant tool
Points in the order email`loyalty.display.order_email`The order confirmation email shows the points the order earned and the points spent on it.	Core`modules/email/templates/order-confirmation.tsx`	Slot · manyAssistant tool
Points in the customer list`loyalty.display.admin_balance`The admin customer list shows each customer's points balance as a column.	Core`modules/customers/admin/columns.tsx`	Slot · manyAssistant tool
Rewards page`loyalty.display.rewards_page`A rewards page explains how to earn and spend points and lists the tiers.	Plugin	Slot · manyAssistant tool
Floating rewards button`loyalty.display.floating_button`A floating rewards button opens a panel on any storefront page with the balance and the ways to earn and spend.	Plugin	Slot · manyAssistant tool

Phrase	Made of
points program	loyalty.points.earn.per_spend loyalty.points.balance.balance loyalty.points.redeem.points_discount
points per dollar	loyalty.points.earn.per_spend
VIP tiers	loyalty.tier.threshold loyalty.tier.benefit
VIP entry reward	loyalty.tier.threshold loyalty.tier.entry_reward
birthday rewards	loyalty.points.earn.birthday
sign-up points	loyalty.points.earn.signup
points for reviews	loyalty.points.earn.review
social follow rewards	loyalty.points.earn.social_follow
double points	loyalty.points.earn.multiplier
points expiry	loyalty.points.expiry.inactivity loyalty.points.expiry.reminder
points redemption	loyalty.points.redeem.rate loyalty.points.redeem.points_discount
free shipping reward	loyalty.points.redeem.free_shipping
free product reward	loyalty.points.redeem.free_product
rewards page	loyalty.display.rewards_page
loyalty launcher	loyalty.display.floating_button
points history	loyalty.points.balance.movement_log

Points and rewards

What the phrases mean

Phrases left out

Sources