Milo Subscription Coupons
Four subscription-aware WooCommerce coupon types: discount the recurring price or the sign-up fee, forever or for a set number of renewals.
Installation
- Install and activate WooCommerce and the free Milo Subscriptions plugin.
- Upload and activate Milo Coupons (Plugins → Add New → Upload).
- Enter your license key under Subscriptions → Licenses to enable updates.
Coupon types
The add-on registers four new discount types in the standard WooCommerce coupon type dropdown:
| Type | What it discounts | On renewals |
|---|---|---|
| Recurring product % discount | A percentage off subscription products in the cart. | Reapplied to every renewal order (or the next X payments, see below). |
| Recurring product discount | A fixed amount off, spread proportionally across the subscription items and capped at their total. | Reapplied to every renewal order (or the next X payments), capped at the renewal subtotal. |
| Sign-up fee % discount | A percentage off the sign-up fee(s) in the cart. | Never applies to renewals; sign-up fees are charged once. |
| Sign-up fee discount | A fixed amount off the sign-up fee(s), capped at the total fees. | Never applies to renewals. |
Sign-up fee discounts appear at checkout as a negative “Sign-up fee discount” line rather than a line item discount, since sign-up fees sit outside normal product pricing.
Creating a coupon
Create the coupon as usual under Marketing → Coupons, pick one of the four types, and set the amount. For the two recurring types an extra field appears:
| Field | Description |
|---|---|
| Active for X payments | Number of renewal payments the coupon applies to. Leave empty or 0 for unlimited renewals. |
The cart totals label reflects this: recurring coupons show “(recurring)” or “(applies to X payments)” next to the coupon code.
How renewals are discounted
- At checkout, any recurring coupons on the order are copied onto the new subscription (code, type, amount, and remaining payments), with a subscription note listing them.
- When a renewal order is created, each active recurring coupon is applied as a discount line on that order, capped so the combined discount never exceeds the order subtotal, and an order note records the amount and codes.
- After each successful renewal payment, limited coupons have their payment counter decremented. When a coupon reaches its limit it stops applying, is removed from the subscription, and a subscription note records its expiry.
The payment limit counts renewal payments only; the first (checkout) payment is always discounted by the coupon itself.
Validation rules
- A subscription coupon can only be applied when the cart contains a subscription product; otherwise the customer sees “This coupon can only be used with subscription products.”
- Sign-up fee coupons additionally require at least one cart item with a sign-up fee.
- All standard WooCommerce coupon restrictions (usage limits, expiry date, allowed products, and so on) still apply at checkout.
FAQ
Can I stack a recurring coupon with a sign-up fee coupon? Yes. They discount different parts of the order (the recurring price versus the one-time fee), so both can be applied to the same checkout.
What happens if I delete or edit the coupon later? Renewal discounts are computed from the data stored on each subscription at checkout time, so existing subscribers keep the deal they signed up with.
Billing modes
Requires WooCommerce; this add-on works in WooCommerce mode only, not in standalone (Stripe-driven) mode.
Did this page miss something?
Tell us and we rewrite it, usually the same day.