Discounts, coupons and gift cards: the parts, in plain words

49 parts and 16 phrases. Apps in this area include Shopify Discounts, Bold Discounts, Discount Ninja, Rise.ai, BOGOS, Stripe Coupons.

Discount rulesdiscount.ruleShowWhat a discount gives, how it is applied, to what, and under which limits.

Discount typediscount.rule.typeShowWhat the discount gives.

How to extend

ProviderMany side by sidediscount rule providerA plugin adds a discount type core does not price, such as buy X get Y, and returns the amount off for a cart.
Assistant toolMany side by sideproposeCouponThe assistant proposes a coupon that staff approve before it is created.

Part	Litestore today	How to extend
Percentage off`discount.rule.type.percent`A percentage discount takes a set percent off the items it applies to.	Core`modules/promotions/discount.ts`	Provider · manyAssistant tool · many
Fixed amount off`discount.rule.type.fixed_amount`A fixed amount discount takes a set sum off, in the store currency.	Core`modules/promotions/discount.ts`	Provider · manyAssistant tool · many
Discount cap`discount.rule.type.max_discount`A discount cap limits a percentage discount to a maximum amount off.	Core`modules/promotions/evaluate.ts`	Provider · manyAssistant tool · many
Free shipping discount`discount.rule.type.free_shipping`A free shipping discount removes the shipping charge when its code or rule applies.	Plugin	Provider · manyAssistant tool · many
Item free or reduced with quantity`discount.rule.type.quantity_get_item`A buy X get Y discount gives set items free or reduced when the cart holds a set quantity of other items.	Plugin	Provider · manyAssistant tool · many
Tiered discount`discount.rule.type.tiered`A tiered discount gives a bigger discount at each higher spend or quantity step, such as 10% over 50 and 20% over 100.	Plugin	Provider · manyAssistant tool · many
Item added free`discount.rule.type.gift_item`A free gift discount adds a set product to the cart at no charge when a condition is met.	Plugin	Provider · manyAssistant tool · many

How it is applieddiscount.rule.applicationShowHow a discount gets onto a cart.

How to extend

EventMany side by sideevent.coupon.redeemedA plugin subscribes to redeemed codes, for example to credit the partner who shared the code.
SlotMany side by sidestorefront.slot.cart.above_checkout_buttonA plugin renders offered codes or a discount banner next to the cart totals.

Part	Litestore today	How to extend
Discount code`discount.rule.application.code`A discount code is a word the shopper types at the cart or checkout to apply the discount.	Core`modules/checkout/cart-discounts.ts`	Event · manySlot · many
Automatic discount`discount.rule.application.automatic`An automatic discount applies itself to every cart that meets its conditions, with no code.	Core`modules/promotions/default-automatic-discounts.ts`	Event · manySlot · many
Private code`discount.rule.application.private_code`A private code is valid but never listed in public code suggestions, and is sent only to chosen people such as in a welcome email.	Core`modules/promotions/storefront/queries.ts`	Event · manySlot · many
Suggested codes`discount.rule.application.suggested_codes`Suggested codes list the public codes a signed-in customer qualifies for during checkout.	Core`modules/checkout/storefront/checkout-extras.ts`	Event · manySlot · many
Partner code`discount.rule.application.partner_code`A creator code belongs to one creator or affiliate, and orders that use it count toward that person's commission.	Core`modules/creators/storefront/collab-coupons.tsx`	Event · manySlot · many
Unique codes`discount.rule.application.unique_codes`Unique codes are many single-use codes for one discount, each given to one person.	Plugin	Event · manySlot · many
Bulk code generation`discount.rule.application.bulk_codes`Bulk code generation creates hundreds or thousands of codes for one discount at once and exports them as a file.	Plugin	Event · manySlot · many
Code in a link`discount.rule.application.link_applied`A discount link is a URL that applies a code to the shopper's cart when opened.	Plugin	Event · manySlot · many

What it applies todiscount.rule.scopeShowWhich part of the order the discount reduces.

How to extend

Core onlyWhich lines a discount reduces stays in core because the same split drives refunds and tax.

Part	Litestore today	How to extend
Whole order`discount.rule.scope.order`An order discount reduces the cart subtotal as a whole.	Core`modules/promotions/discount.ts`	Core only
Chosen products`discount.rule.scope.product`A product discount reduces only the cart lines for the products it names.	Core`modules/promotions/target-resolver.ts`	Core only
Collection`discount.rule.scope.collection`A collection discount reduces only the cart lines for products in one collection.	Core`modules/promotions/target-resolver.ts`	Core only
Shipping`discount.rule.scope.shipping`A shipping discount reduces only the shipping charge.	Plugin	Core only

Conditionsdiscount.rule.conditionShowWhat must be true for the discount to apply.

How to extend

ProviderMany side by sidediscount rule providerA plugin adds a condition, such as a customer tag, and returns whether a cart passes it.

Part	Litestore today	How to extend
Minimum spend`discount.rule.condition.min_spend`A minimum spend condition applies the discount only when the cart subtotal before discount reaches a set amount.	Core`modules/promotions/evaluate.ts`	Provider · many
Minimum quantity`discount.rule.condition.min_quantity`A minimum quantity condition applies the discount only when the cart holds a set number of qualifying items.	Plugin	Provider · many
First order`discount.rule.condition.first_order`A first order condition applies the discount only to a customer with no earlier paid order.	Core`modules/checkout/price-resolution.ts`	Provider · many
Returning customer`discount.rule.condition.returning_customer`A returning customer condition applies the discount only to a customer with an earlier paid order.	Core`modules/checkout/price-resolution.ts`	Provider · many
Earlier unpaid cart`discount.rule.condition.unpaid_cart`A cart abandoner condition applies the discount to a shopper who left an earlier cart unpaid.	Core`modules/checkout/price-resolution.ts`	Provider · many
Large cart`discount.rule.condition.large_cart`A high intent condition applies the discount to a large cart, such as one over a set value or with several different products.	Core`modules/checkout/price-resolution.ts`	Provider · many
Chosen customers`discount.rule.condition.customer_eligibility`A chosen customers condition applies the discount only to named customers or a customer segment.	Plugin	Provider · many
Currency match`discount.rule.condition.currency_match`A currency match condition rejects a fixed amount discount in a cart of a different currency.	Core`modules/promotions/evaluate.ts`	Provider · many

Limits and combiningdiscount.rule.limitShowHow often, when, and alongside what a discount may be used.

How to extend

Core onlyUsage counts and limits stay in core because they are enforced under a lock at payment.

Part	Litestore today	How to extend
Total usage limit`discount.rule.limit.usage_limit`A total usage limit caps how many orders across all customers may use the discount.	Core`modules/promotions/evaluate.ts`	Core only
Per-customer limit`discount.rule.limit.per_customer`A per-customer limit caps how many times one customer may use the discount, often once.	Core`modules/promotions/evaluate.ts`	Core only
Start and end dates`discount.rule.limit.schedule`Start and end dates set the window in which the discount is valid.	Core`modules/promotions/coupon-live-window.ts`	Core only
One discount per cart`discount.rule.limit.single_discount`A one-discount rule allows a single code or points redemption per cart, and applying one replaces the other.	Core`modules/checkout/cart-discounts.ts`	Core only
Automatic discount priority`discount.rule.limit.priority`Automatic discount priority picks the highest-ranked automatic discount when a cart qualifies for several.	Core`platform/config/pricing.ts`	Core only
Discount combinations`discount.rule.limit.combination`Discount combinations list which other discounts a discount may be used with on the same order.	Plugin	Core only

Stored valuediscount.valueShowBalances a customer spends like money: gift cards and store credit.

Gift cardsdiscount.value.gift_cardShowStored value bought or issued as a code and spent at checkout.

How to extend

EventMany side by sideevent.order.paidA gift card plugin subscribes to paid orders to issue its own cards.
Core onlyGift card balances stay in core because they are conserved amounts spent at checkout.

Part	Litestore today	How to extend
Gift card product`discount.value.gift_card.sell_card`A gift card product is sold like any product, and paying for it issues a gift card code for its value.	Core`modules/promotions/gift-cards.ts`	Event · manyCore only
Gift card email`discount.value.gift_card.delivery_email`A gift card email sends the code and value to the buyer once the order is paid.	Core`modules/email/templates/gift-card-issued.tsx`	Event · manyCore only
Gift card balance`discount.value.gift_card.balance`A gift card balance holds the amount left on a card, and a card with no balance is rejected.	Core`modules/promotions/evaluate.ts`	Event · manyCore only
Partial redemption`discount.value.gift_card.partial_redemption`Partial redemption spends part of a gift card on one order and keeps the rest for later orders.	Core`modules/orders/payments/payment-webhook.ts`	Event · manyCore only
Gift card expiry`discount.value.gift_card.expiry`A gift card expiry date ends the card's validity, after which it is rejected.	Core`modules/promotions/evaluate.ts`	Event · manyCore only
Customer gift card list`discount.value.gift_card.customer_list`A customer gift card list shows the cards a customer owns with their balances in the account area.	Core`modules/promotions/gift-cards.ts`	Event · manyCore only
Scheduled gift to recipient`discount.value.gift_card.recipient_schedule`A scheduled gift sends the card to a named recipient on a chosen date with a message from the buyer.	Plugin	Event · manyCore only
Physical gift card`discount.value.gift_card.physical_card`A physical gift card is a printed card with a code that is redeemed online or in a shop.	Plugin	Event · manyCore only

Store credit and pointsdiscount.value.creditShowBalances a customer earns or is given and spends at checkout.

How to extend

Core onlyCredit and points balances stay in core because every change is a ledger movement tied to an order or refund.

Part	Litestore today	How to extend
Store credit`discount.value.credit.store_credit`Store credit is a balance on the customer's account, such as from a refund, that is spent as money off later orders.	Core`modules/orders/refunds/refund-requests.ts`	Core only
Points redemption`discount.value.credit.points_redemption`Points redemption converts loyalty points into money off the cart at a set rate.	Core`modules/promotions/loyalty`	Core only
Credit from order value`discount.value.credit.order_value_credit`Cashback credit adds a percentage of an order's value to the customer's balance after the order.	Plugin	Core only

Sale pricesdiscount.saleShowLower prices set on the product itself, without a code.

How to extend

SectionMany side by sidestorefront.section.countdownA countdown section shows the time left in a sale on a storefront page.
Assistant toolMany side by sideproposeProductPriceUpdateThe assistant proposes a price change that staff approve.

Part	Litestore today	How to extend
Sale price`discount.sale.sale_price`A sale price is a lower price stored on a variant beside its regular price.	Core`modules/products/pricing/core.ts`	Section · manyAssistant tool · many
Crossed-out regular price`discount.sale.reference_price`A compare-at price shows the regular price crossed out next to the sale price.	Core`modules/products/pricing/core.ts`	Section · manyAssistant tool · many
Sale window`discount.sale.sale_window`A sale window sets the start and end time of a sale price, outside which the regular price applies.	Core`modules/products/pricing/core.ts`	Section · manyAssistant tool · many
Sale countdown`discount.sale.countdown`A sale countdown shows the time left until a sale ends.	Core`modules/storefront/sections/discount-timer.tsx`	Section · manyAssistant tool · many
Sold share bar`discount.sale.sold_share`A claimed stock bar shows the share of a limited sale quantity already sold.	Planned	Section · manyAssistant tool · many

Phrase	Made of
BOGO	discount.rule.type.quantity_get_item
buy one get one free	discount.rule.type.quantity_get_item
tiered discount	discount.rule.type.tiered
volume discount	discount.rule.condition.min_quantity discount.rule.type.tiered
stackable discounts	discount.rule.limit.combination
unique codes	discount.rule.application.unique_codes
bulk discount codes	discount.rule.application.bulk_codes
shareable discount link	discount.rule.application.link_applied
automatic discount	discount.rule.application.automatic
welcome discount	discount.rule.condition.first_order discount.rule.application.private_code
store credit	discount.value.credit.store_credit
gift with purchase	discount.rule.type.gift_item
flash sale	discount.sale.sale_price discount.sale.sale_window discount.sale.countdown
compare at price	discount.sale.reference_price
e-gift card	discount.value.gift_card.sell_card discount.value.gift_card.delivery_email
influencer code	discount.rule.application.partner_code

Discounts, coupons and gift cards

What the phrases mean

Phrases left out

Sources