Coupons
| Field | Value |
|---|---|
| Audience | public |
| Page type | reference |
| Area | sg-admin |
| Updated | 2026-05-14 |
The SG-Admin Coupons module — discount rules, codes, expiry, usage tracking.
The Coupons module in the admin is the per-site surface for administering discount rules. Operators create coupon codes with discount type, scope, expiry, and usage limits; the codes apply at checkout via the Coupon Entry block; the redemption records to Orders for audit. This page is the Reference definition.
What is this for?
Read this page when you want the structural definition of the Coupons module — discount-rule shapes, scope targeting, and usage tracking.
Good use cases
- You are scoping a promotion campaign.
- You are explaining to a stakeholder how SGEN handles checkout discounts.
- You hit a "how do I limit this coupon to one product?" question and want the model laid out.
What NOT to use this for
- Step-by-step procedures — open the relevant Guide.
- Per-release shipped change — open What's New or Changelog.
How this connects to other features
- SG-Admin Overview — parent surface.
- Products — coupons can scope to specific products.
- Orders — redemption surfaces in the order record.
- Ecommerce Blocks — Coupon Entry block.
Where to find it
Open SG-Admin for the active site. Coupons is in the sidebar under the store management group (alongside Products and Orders). Admin access is required to create and manage coupon rules.
Definition
A coupon in the admin is a discount rule. Each coupon carries a code (the string customers enter at checkout), a discount type (percentage / fixed amount / free shipping), a scope (entire cart / specific products / specific categories), an expiry date (or none), and usage limits (per-customer / total).
The defining property is rule + code. Coupons exist as configured rules; customers redeem them by entering the code at checkout.
Purpose
The purpose of this page is to define the Coupons module as a Reference layer.
Scope
This page covers Coupons at the Reference level.
The page covers:
- The coupon record model.
- Discount types.
- Scope targeting.
- Expiry and usage limits.
- The redemption surface in Orders.
- Per-step procedures — Guides.
- Per-release shipped change — What's New or Changelog.
The coupon record model
Each coupon carries:
- Code — the string customers enter (case-insensitive typically).
- Discount type — percentage / fixed amount / free shipping.
- Discount value — number per the type (e.g., 20 for 20% or 10 for $10 off).
- Scope — entire cart / specific products / specific categories.
- Expiry — date after which the coupon stops working.
- Usage limit total — maximum redemptions across all customers.
- Usage limit per customer — maximum redemptions per customer.
- State — active / expired / disabled.
Site · SG-Admin · Coupons
Active rules
| Code | Type | Scope | Expiry | Used | Status |
|---|---|---|---|---|---|
| Q2LAUNCH | 20% off | Entire cart | 2026-06-30 | 147 / unlimited | Active |
| FREESHIP100 | Free shipping | Cart over $100 | 2026-12-31 | 62 / 500 | Active |
| VIP15 | $15 off | Featured products | 2026-05-15 | 12 / unlimited | Active |
| SPRING10 | 10% off | Spring collection | 2026-04-30 | 89 / 100 | Expired |
Discount types
Percentage
Apply N% off the scoped subtotal.
Fixed amount
Apply a flat $N off the scoped subtotal.
Free shipping
Override shipping cost to zero (typically gated by minimum cart value).
Scope targeting
Entire cart
The discount applies to the cart subtotal across all products.
Specific products
The discount applies only when the cart contains the named products (or any subset of them).
Specific categories
The discount applies to products in the named categories.
Redemption tracking
When a coupon is redeemed at checkout:
- The coupon record's usage count increments.
- The order record carries the coupon reference for audit.
- Per-customer limits enforce against subsequent orders from the same customer.
Constraints and boundaries
Coupons is a Reference area for the discount-rule model.
Use this Reference for:
- Understanding the coupon record and discount types.
- Confirming scope targeting and usage limits.
- Per-step procedures — Guides.
- Order processing — Orders Reference.
- Per-release shipped change — What's New or Changelog.
Public boundary
This page is intentionally public-safe.
Examples
Example 1 — Operator launches a 20% off promo
Operator creates a coupon code LAUNCH20 with 20% discount, entire-cart scope, 30-day expiry, no usage cap. Distributes the code via marketing email. Customers redeem at checkout; usage count climbs.
Example 2 — Operator scopes a coupon to one category
Operator creates SPRING10 with 10% discount scoped to the Spring category. Coupon only applies when cart contains Spring-category products.
Example 3 — Coupon hits usage limit
VIP100 was capped at 100 redemptions. The 101st customer enters the code; the platform rejects the redemption; the order proceeds at full price.
Documentation guidance
Use this page as the structural definition for the Coupons module.
Reading order
Open this page when scoping promotion campaigns. Pair with Orders for the redemption-record context.
Related reading
- SG-Admin Overview — parent surface.
- Products — products that coupons can scope to.
- Orders — redemption records.
- Ecommerce Blocks — Coupon Entry block.
Vocabulary cross-reference
- Coupon is one discount-rule record.
- Code is the string customers enter at checkout.
- Scope is what the discount applies to (cart / products / categories).
- Usage limit is per-coupon (total) or per-customer cap.
- Redemption is one successful application of the coupon to an order.
Maintenance discipline
When the Coupons module changes across releases (new discount type, new scope dimension, new usage-limit rule), update this Reference and log the change in Changelog.
Related reading
| Topic |
|---|
| SG-Admin |
| Products |
| Orders |
| Ecommerce Blocks |