Promotion codes are customer-facing codes attached to a coupon. They let customers enter a code during checkout and receive the discount defined by the underlying coupon. A coupon controls the discount itself: fixed amount or percentage, eligible products, and global redemption rules. A promotion code controls how customers can redeem that coupon from checkout: the code value, customer or product eligibility, expiration date, redemption limit, and duration.Documentation Index
Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
Use this file to discover all available pages before exploring further.
When to use promotion codes
Use promotion codes when customers should redeem a discount without your team applying it manually. Common examples include public acquisition campaigns, partner discounts, customer-specific offers, and first-order incentives. Use the coupon directly when the discount should be applied by your team while creating a subscription, preparing a quote, or editing an invoice.Example 💡
Create a 20% annual discount coupon, then add one promotion code for a public campaign (
SPRING20) and another for a partner (PARTNER20). Both codes apply the same discount, but each code can have its own expiration date, redemption limit, and eligibility rules.Create a promotion code
Promotion codes are managed from the coupon they redeem.- Go to Catalog > Coupons.
- Open the coupon you want customers to redeem.
- In Promotion codes, click Add promotion code.
- Enter the Code customers will type at checkout.
- Configure the eligibility and limits.
- Click Save changes.
Promotion code settings
| Setting | Description |
|---|---|
| Code | The value customers enter at checkout, such as SPRING20 or PARTNER20. |
| Customer | Optional restriction to one customer. Leave empty to make the code available to all customers. |
| Product | Optional restriction to subscriptions containing a specific product. Leave empty to use the coupon’s product eligibility only. |
| Expiration date | Optional date after which the code can no longer be redeemed. |
| Maximum redemptions | Optional limit for this promotion code. This is tracked separately from the coupon redemption limit. |
| Duration | How long the redeemed discount applies after checkout. Leave empty to use the coupon’s default duration, or choose a specific duration such as once, days, weeks, months, or years. |
| First order only | Restricts the code to customers placing their first order. |
Promotion code limits do not replace coupon limits. A checkout redemption must satisfy both the promotion code settings and the underlying coupon settings.
Redeem a promotion code at checkout
When at least one promotion code exists on your account, the checkout page displays an Add promo code option. Customers can enter a code, apply it, and see the discount reflected in the checkout summary before completing payment. If the code is expired, over its redemption limit, restricted to another customer or product, or otherwise not eligible for the checkout, Hyperline shows an invalid code message and does not apply the discount.Manage promotion codes
Open the coupon to review all related promotion codes. The list shows each code, redemption count, expiration, duration, and whether it is restricted to first orders. You can edit a promotion code while it is active, or delete it when it should no longer be available at checkout. Deleting a promotion code prevents future redemptions but does not remove discounts already applied to subscriptions.Coupons and promotion codes
Coupons and promotion codes work together:| Concept | Purpose | Managed by |
|---|---|---|
| Coupon | Defines the discount amount, discount type, and base eligibility. | Internal teams applying discounts manually or creating codes. |
| Promotion code | Defines how a customer can redeem a coupon during checkout. | Teams running campaigns, partner offers, or self-serve checkout flows. |
Next steps
- Review the underlying Coupons setup.
- Learn how checkout pages work in Checkout page.