Skip to content

Coupons

Coupons let you offer discounts to your customers during checkout. You can create percentage-based or fixed-amount coupons that apply to the entire order, a specific product, or the shipping cost. Each coupon has a unique code that customers enter at checkout to receive the discount.

Capyshop supports three discount types:

Discount TypeWhat It Discounts
Order DiscountReduces the order subtotal (before shipping and tax)
Product DiscountReduces the price of a specific product in the cart
Shipping DiscountReduces the shipping cost

Browsing your coupons

Open Coupons in the admin sidebar to see the full list. The table displays each coupon's code, name, type, discount value, number of uses, status, and an actions menu.

Coupons list

ColumnDescription
CodeThe unique coupon code (click to edit)
NameDisplay name for the coupon
TypeOne of: Order Discount, Product Discount, or Shipping Discount
DiscountThe discount value shown as a percentage (e.g., 46%) or fixed amount (e.g., $40.30)
UsesHow many times the coupon has been used
StatusActive, Inactive, or Expired
ActionsDropdown with Edit and Delete options

You can sort by clicking any column header, search by typing in the search bar, and filter by status (All, Active, Inactive, Expired) using the Filter button.

Bulk actions

Select multiple coupons using the checkboxes to reveal bulk action buttons:

  • Activate — enable selected coupons
  • Deactivate — disable selected coupons
  • Delete — permanently remove selected coupons (with confirmation)

Creating a coupon

Click New Coupon on the list page to open the creation form.

Create coupon

Coupon details

FieldRequiredDescription
NameYesA display name for the coupon (e.g., "Summer Sale")
CodeYesThe code customers will enter at checkout. Automatically converted to uppercase. Not case-sensitive when applied
ActiveNoToggle to enable or disable the coupon. Only active coupons can be applied at checkout

Rule configuration

FieldRequiredDescription
Discount TypeYesChoose between Order Discount, Product Discount, or Shipping Discount
Value TypeYesChoose between Percentage (%) or Fixed Amount
ValueYesThe discount value (e.g., 20 for 20%, or 10.00 for $10.00 off)
ProductConditionalOnly shown when Discount Type is Product Discount. Select the specific product that must be in the cart
Usage RuleYesMultiple Use (unlimited), Single Per Customer (once per customer), or Single Overall (one use total)
Minimum Order AmountNoThe minimum order subtotal required to apply this coupon
Expiration DateNoThe coupon will automatically become invalid after this date
Target CountriesNoRestrict this coupon to customers shipping to specific countries. If left empty, the coupon is valid for all countries

Editing a coupon

Click any coupon code in the list (or choose Edit from the actions dropdown) to open the edit form. It contains the same fields as the creation form, pre-populated with the current data.

Edit coupon

Click Save Changes when you are done.

Deleting a coupon

To delete a coupon, click the actions dropdown on the row and select Delete. A confirmation dialog will appear before the coupon is permanently removed.

How coupons work at checkout

During checkout, customers can enter a coupon code in the Coupon Code field on the order summary panel.

Checkout coupon field

Validation

When a customer enters a coupon code, the system checks the following before applying it:

  1. The coupon must be active
  2. The coupon must not be expired
  3. The order must meet the minimum order amount (if set)
  4. The customer's shipping country must match the coupon's target countries (if set)
  5. For Product Discount coupons, the specified product must be in the cart
  6. The coupon must pass the usage rule check:
    • Multiple Use — always passes
    • Single Per Customer — the customer must not have used this coupon before
    • Single Overall — the coupon must not have been used by anyone

If any check fails, the customer sees an error message explaining why the coupon cannot be applied.

How discounts are calculated

Discount TypePercentageFixed Amount
Order DiscountSubtotal x (value / 100)Flat amount off the subtotal (capped at subtotal)
Product DiscountProduct total x (value / 100)Flat amount off the product total (capped at product total)
Shipping DiscountShipping cost x (value / 100)Flat amount off shipping (capped at shipping cost)

Important: Only one coupon can be applied per order. Customers can remove a coupon and apply a different one before completing their order.

Tip: Coupon codes are not case-sensitive. A customer can enter "summer2024" or "SUMMER2024" and both will work for the code SUMMER2024.